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ABSTRACT 


SACS  is  a  cache  simulator  that  provides  the  user  with  a  wide  range  of  timing 
information,  in  addition  to  providing  typical  information  such  as  hit  and  miss  rates.  The 
SACS  model  includes  read  and  write  buffers,  main  memory,  and  cache  memory.  In 
addition,  SACS  supports  a  number  of  buffer  and  data  forwarding  policies,  as  well  as  the 
traditional  block  replacement,  write,  and  write  miss  policies.  SACS  also  includes  a 
self-testing  mode  which  can  be  used  to  debug  the  program  after  source-code  modification 
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I.  INTRODUCTION 


A.  CACHE  MEMORIES 

Cache  memories  are  usually  small  memories  that  contain  blocks  of  data  and/or 
instructions  [Ref  1]  Each  block  is  a  copy  of  consecutive  data  and/or  instruction  bytes 
from  main  memory  Caches  are  usually  much  faster  than  their  main  memory  counter  parts. 
They  are,  in  effect,  short  term  memory.  The  cache  contains  a  set  of  blocks  recently 
accessed  by  the  CPU  The  cache  can  provide  the  most  recently  used  data  and/or 
instructions  to  the  CPU  in  less  time  than  it  would  have  taken  to  get  the  information  from 
main  memory  However,  if  the  cache  fails  to  provide  the  information,  then  it  fetches  the 
information  from  main  memory  and,  depending  on  its  design,  may  choose  to  enter  the 
information  into  the  cache.  The  cache  also  performs  memory  updates  in  the  form  of  writes. 
Memory  updates  can  occur  when  the  CPU  makes  a  write  request,  or  the  cache  can  store 
new  data  in  the  cache  blocks  and  wait  until  later  to  write  the  data  to  memory  [Ref  2;p.  1 97 
]  A  dirty  block  is  a  cache  block  which  contains  data  that  is  more  current  than  memory 
because  of  a  recent  wnte  request. 

The  concept  of  the  cache  storing  recently  used  memory  blocks  is  very  simple.  In 
fact,  many  early  cache  designs  were  simple  implementations  of  the  concept.  However,  the 
task  of  building  an  optimized  cache  is  not  trivial  The  difficulty  comes  from  trying  to 
provide  the  CPU  with  the  correct  data  or  instruction  as  soon  as  it  is  available.  For  example. 


if  a  block  read  is  in  progress  and  there  is  enough  data  available  to  satisfy  the  pending  load, 
the  data  should  be  forwarded  to  the  CPU  rather  than  waiting  for  the  block  read  and  cache 
update.  The  cache  often  performs  block  management  between  requests.  One  example  of 
block  management  is  wnting  dirty  data  to  memory  Another  example  is  reading  data  that 
was  not  part  of  the  CPU  request,  but  located  in  the  same  block  This  allows  the  cache  to 
contain  all  the  data  that  was  in  the  block.  An  optimized  cache  performs  block  management 
only  after  completing  the  CPU  request  Complications  arise  when  the  CPU  makes  another 
request  before  the  block  management  for  the  last  request  is  complete  If  this  happens,  the 
cache  has  to  search  for  data  m  the  control  sections  of  the  cache  as  well  as  the  cache 
memory. 

More  and  more  cache  designs  incorporate  read  and  write  buffers  in  their  control 
sections.  These  buffers  allow  the  cache  to  perform  block  management  while  minimizing 
the  effect  on  the  CPU  request  [Ref  3].  For  example,  if  a  CPU  read  request  results  in  a 
miss  and  the  block  victim  has  a  dirty  sub  block,  then  writing  the  dirty  sub  block  to  memory 
may  occur  after  reading  the  replacement  block.  This  allows  the  cache  to  forward  the  read 
data  to  the  CPU  before  writing  the  old  data  to  memory  Figure  1  provides  a  simplified  data 
flow  diagram  that  illustrates  buffer  use  in  modem  cache  designs 

Scoreboarding  is  a  term  that  has  been  used  to  describe  the  process  of  searching,  and 
choosing  the  correct  value  of  a  register  argument.  Scoreboarding  in  a  cache  represents  the 
act  of  searching  and  altering  buffers  based  on  new  CPU  requests  One  example  of 
scoreboarding  is  searching  a  buffer  for  CPU  requested  data  Searching  block  and  write 


2 


Figure  1  Typical  Cache  Data  Flow  Design 


buffers  may  provide  data  that  is  not  available  in  the  cache  memory  Searching  the  read 
buffer  ensures  that  no  duplicate  read  requests  are  placed  in  the  buffer.  However,  it  will  not 
provide  any  new  data  Another  example  of  scoreboarding  is  updating  read  requests  in  the 
read  buffer  with  data  provided  by  CPU  write  requests. 

B.  PROBLEMS  OF  CACHE  MEMORIES 

Cache  memories  can  cause  more  problems  than  they  solve  and  they  can 
significantly  complicate  the  memory  model  The  most  obvious  problem  with  a  cache 
memory  is  that  it  does  not  always  contain  the  data  that  the  CPU  requests.  This  is  defined 
as  a  read  miss.  A  write  miss  is  when  the  CPU  makes  a  write  request  and  the  correct  block 
is  not  in  the  cache  Conversely,  a  read  hit  is  when  the  data  is  available,  and  a  write  hit  is 
when  the  block  is  available  There  are  three  types  of  cache  misses  [Ref  4:p  419]  First, 
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the  compulsory  miss  results  when  data  is  accessed  for  the  first  time  Second,  the  capacity 
miss,  occurs  when  the  cache  is  not  big  enough  to  carry  all  the  blocks  required  The  third 
type,  collision  misses,  occurs  when  the  cache  requires  severaJ  main  memory  blocks  that 
map  to  the  same  set  of  cache  blocks.  This  causes  a  form  of  thrashing  similar  to  that  seen  in 
virtual  memones 

In  some  numerical  calculations,  the  cache  makes  the  average  access  time  greater 
than  the  main  memory  access  and  transfer  times  This  is  often  due  to  matrix  operations  that 
access  elements  across  rows  and  force  the  cache  to  enter  an  entire  block  of  data  for  each 
element  read  Depending  on  the  size  of  the  matrix,  it  may  not  be  possible  to  save  enough 
blocks  to  ensure  that  the  next  block  accessed  was  not  selected  as  a  victim  and  replaced  As 
a  result,  many  architectures  support  special  load  and  store  instructions  that  bypass  »he 
cache 

C.  EXISTING  CACHE  SIMULATORS 

There  are  a  number  of  cache  simulators.  Two  examples  include  Dinero  ED.  and 
Tyco  [Ref  5]  Dinero  IE  provides  hit  and  miss  data  for  a  wide  range  of  input  arguments 
Dinero  IE  will  also  simulate  either  a  unified  cache,  or  separate  data  and  instruction  caches 
Tyco,  on  the  other  hand,  simulates  several  different  cache  options  simultaneously  for 
comparison 

D.  PROBLEMS  WITH  EXISTING  CACHE  SIMULATORS 

Unfortunately,  both  Dinero  Hi  and  Tyco  limit  their  simulations  to  hit-miss 
calculations  With  nothing  but  hit-miss  information,  the  designer  cannot  optimize  his  cache 
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for  the  lowest  aver;i<'  access  time  Most  caches  are  designed  to  have  low  average  access 
times  rather  than  high  hit  rates  [Ref  4:p  405]  Since  Dinero  III  and  Tyco  do  not  perform 
r'nv  liming  analysis,  they  may  mislead  the  designer  Dinero  III  and  Tyco  also  do  not 
provide  any  buffer  simulations  because  they  assume  that  the  cache  has  all  the  time  it  needs 
between  loads  and  stores  to  complete  all  of  its  block  management  Since  buffer 
management  and  scoreboarding  have  such  a  large  effect  on  the  average  access  time,  there 
is  an  obvious  need  for  a  simulator  that  can  perform  accurate  timing  analysis,  buffer 
management,  and  scoreboarding 
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II.  INTRODUCTION  TO  SACS 


A.  THE  NEED  FOR  STILL  ANOTHER  CACHE  SIMULATOR 

A  cache  simulator  should  not  only  simulate  the  cache  memory,  it  should  simulate 
mam  memory  and  any  buffers  it  uses  As  discussed  earlier,  neither  Dinero  III  nor  Tyco 
provide  any  means  for  simulanng  buffers  or  memory 

Without  timing  analysis,  the  designer  is  unable  to  determine  the  effect  of 
scoreboarding  protocols.  These  protocols,  which  are  usually  veiy'  difficult  to  implement, 
can  be  avoided  by  delaying  any  read  requests  until  all  writes  are  completed  and  the  last 
read  block  has  been  entered  into  the  cache  Timing  analysis  allows  the  designer  to  choose 
the  scoreboarding  technique  that  best  suites  his  or  her  resources  and  architectural 
requirements  A  hit-miss  cache  simulator  reduces  this  process  to  guess  work 

B.  COMPARING  SACS  TO  OTHER  CACHE  SIMULATORS 

As  previously  discussed,  other  cache  simulators  provide  hit-miss  results,  while 
SACS  provides  the  all  important  average  access  time  However,  in  addition  to  the  correct 
performance  measurements,  a  simulator  should  illustrate  a  cache's  strengths  and 
weaknesses  It  should  give  the  user  a  clear  understanding  of  how  to  improve  the  cache's 
design  With  Dinero  HI,  the  user  could  only  guess  on  how  to  improve  his/her  cache  design 
Tyco  attempted  to  correct  this  problem  by  allowing  the  user  to  simulate  several  caches 
simultaneously  However,  given  the  number  of  different  variables  and  policy  choices. 
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exhausting  all  possible  combinations  is  not  the  best  way  to  design  a  cache.  SACS  is  unique 
because  it  provides  the  user  with  a  detailed  analysis  of  exactly  what  the  cache  was  doing 
during  a  simulation  run.  The  user  can  then  identify  and  correct  specific  problems  with  a 
cache  design. 

C.  THE  CAPABILITIES  OF  SACS 

SACS  allows  the  designer  to  experiment  with  different  policies  while  measuring 
their  affect  on  the  average  access  time.  SACS  provides  the  user  with  more  detailed 
information  because  it  maintains  a  log  of  how  every  clock  cycle  is  spent.  This  log  is  kept  in 
the  form  of  a  histogram  It  allows  the  user  to  see  exactly  how  much  time  is  spent 
performing  read  or  write  requests.  It  also  records  how  many  times  a  request  was 
completed  within  a  given  time  period.  With  these  details,  the  user  can  easily  evaluate  the 
cache's  performance.  A  second  histogram  is  available  which  details  the  amount  of  time 
spent  performmg  cache  accesses,  memory  accesses,  and  waiting  for  full  buffers.  With  this 
histogram,  the  designer  can  target  specific  weaknesses.  It  also  provides  a  good  comparison 
of  the  effect  of  different  scoreboarding  policies  between  runs. 
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III.  SACS  INPUT  PARAMETERS 


A.  INTRODl'CTION 

SACS  provides  a  wide  range  of  input  parameters  to  model  various  different 
functionally  diverse  caches.  While  it  is  impossible  to  imagine  what  kinds  of  caches 
designers  might  build  in  the  future,  every  effort  was  made  to  allow  the  designer  to  simulate, 
or  most  nearly  approximate,  his  or  her  design.  Table  1  lists  arguments  that  SACS 
supports. 


TABLE  1. 

SACS  INPUT  ARGUMENTS 

Cache  Size  (-cs  n) 

Read  Forward  (-rf  -drf) 

Blocks  Size  (-bs  n) 

CPU  Waits  For  Cache  Writes  (-ewfew  -dewfew) 

Sub  Block  Size  (-sbs  n) 

Search  Block  Buffer  (-sbb,  -dsbb) 

Associativity  (-a  n) 

Update  Read  Buffer  (-urb,  -durb) 

fVord  Size  f-ws  n) 

Remove  Read  Duplicates  (-rrd,  -drrd) 

Bead  Cache  /Access  Time  (-rcat  n) 

Remove  Write  Duplicates  (-rwd,  -drwd) 

Read  Cache  Hit  Time  (-rcht  n) 

Read  Priority  (-rpr  n) 

Read  Cache  Miss  Time  (-rcmt  n) 

Write  priority  (-wpr  n) 

Write  Cache  Access  Time  (-wcat  n) 

Read  For  Write  Allocate  Priority  (-rfwapr  n) 

Write  Cache  Hit  Time  (-wcht  n) 

Write  Dirty  Block  Priority  (-wdbpr  n) 

Write  Cache  Miss  Time  (~wcmt  n) 

No  Priority  (~npr  n) 

Memory  Access  Time  (-mat  n) 

Trace  (-t,  -dt) 

Memory  Transfer  Time  (-mtt  n) 

Check  (-C,  -dc) 

Buffer  Cache  Access  Time  (-heat  n) 

Test  (-test) 

Read  Buffer  Size  (-rhs  n) 

Key  Board  lO  (-kbio,  -fio) 

Write  Buffer  Size  (-wbs  n) 

Data  File  Name  (-f  "File  Name") 

Block  Replacement  Policy  (-brp  el) 

Screen  Histogram  Max  Index  (-shmi  n) 

Write  Policy  (-wp  e2) 

Write  Miss  Policy  (-wmp  e3) 

File  Histogram  Max  Index  (-fhmi  n) 

n  Unnanvd  itittscr 

el  enumeration  type  ILRl’,  FIFO.  RANhl 
e2  emuiicration  type  I  Wnte  1'hrouah.  Wnie  back ) 
e>  enumcraUtm  tyiie  <  Write  Aronnii.  Wnie  AlKicatc  I 
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B.  SIZE  ARGUMENTS 


All  sizes  are  entered  in  bytes.  Cache  Size  must  be  an  even  multiple  of  both  Bloc.  '< 
Size  and  Associativity.  Block  size  must  be  an  even  multiple  oi  Sub  Block  Size,  and  Sub 
Block  Size  must  be  an  even  multiple  of  Word  Size.  Word  Size  may  be  any  positive  integer 
that  does  not  force  an  integer  overflow  in  Cache  Size  or  Block  Size. 

C.  CACHE  ACCESS,  HIT,  AND  MISS  ARGUMENTS 

Cache  Access  Times  represent  the  time  required  for  a  request  to  access  the  cache, 
providing  the  cache  is  not  busy.  At  the  end  of  this  time  it  is  determined  whether  the  request 
is  a  hit  or  a  miss  The  Cache  Hit  Time  represents  the  time  required  to  complete  a  request 
once  the  cache  access  time  has  expired  and  the  request  has  been  identified  as  a  hit.  If  the 
request  was  a  miss,  then  the  Cache  Miss  Time  is  used  instead. 

D.  MEMORY  ACCESS  AND  TRANSFER  TIME  ARGUMENTS 

The  Memory  Access  Time  is  the  time  required  for  a  buffer  to  access,  and  then 
transfer,  the  first  word  of  a  request  from  memory.  Memory  Transfer  Time  is  the  time 
required  for  a  buffer  to  transfer  each  consecutive  word  following  the  first  access. 

E.  BUFFER  ARGUMENTS 

After  a  memory  read,  the  Block  Buffer  contains  the  new  data  that  must  be  entered 
into  the  cache.  The  time  that  the  Block  Buffer  xzkes  to  access  the  cache  is  called  the  Buffer 
Cache  Access  Time.  The  Block  Buffer  may  have  to  wait  longer  because  the  cache  is  busy. 
The  buffer  cache  access  will  not  occur  if  a  read  or  write  cache  access  is  required  during  the 
same  clock  cycle.  However,  once  the  access  begins,  the  read  and  write  cache  accesses  are 


9 


locked  out  until  the  cache  is  updated.  The  Read  and  Write  Buffer  sizes  can  be  any  positive 
non  zero  integer  (<100). 

F.  CACHE  POLICY  ARGUMENTS 

Block  replacement  policy  determines  the  method  used  to  choose  the  location  of  a 
new  block  in  the  cache.  SACS  supports  three  block  replacement  policies;  Least  Recently 
Used  {LRlf),  First  In  First  Out  (FIFO),  and  Random  (RAND).  There  are  two  write 
policies:  Write  Through,  and  Write  Back.  The  Write  Through  policy  forwards  the  data  to 
memory  immediately  after  a  write  request.  However,  in  the  Write  Back  policy,  the  data  is 
saved  in  the  cache  until  the  block  that  contained  the  data  is  selected  as  a  victim.  Dirty  bits 
indicate  which  sub  blocks  have  new  data  that  must  be  written  to  main  memory. 

SACS  can  easily  be  modified  to  support  new  write,  or  write  miss  policies  by  adding 
the  new  policy  name  to  Write  Policy  Types,  or  the  Write  Miss  Policy  Types  in  SACS.h. 

The  code  to  simulate  these  new  policies  must  be  placed  in  the  procedures  Write  Hit,  and/or 
Write  Miss  which  are  both  located  in  Cache.c.  New  block  replacement  policies  may  also 
be  added  by  modifying  Replacement  Policy  Types  in  SACS.h,  and  Select  Block  Victim  in 
Cache.c. 

If  CPU  Waits  For  Cache  Writes  is  asserted  the  CPU  will  wait  after  a  write  request 
until  the  cache  is  complete  with  the  write  Otherwise,  it  is  assumed  that  the  cache  can  carry 
out  the  wnte  while  the  CPU  continues  with  other  instructions. 

If  Read  Forward  is  asserted,  then  a  read  miss  is  complete  once  the  data  required 
arrives  in  the  block  buffer.  Otherwise,  the  read  must  wait  until  the  block  updates  the  cache. 
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G.  SEARCH  BUFFERS  AND  UPDATE  BUFFER  ARGUMENTS 

Search  Block  Buffer  allows  the  cache  to  search  the  block  buffer  in  case  the  read 
data  was  already  received  from  memory.  If  any  part  of  the  data  is  found  in  the  buffer,  then 
the  size  of  the  request  will  be  appropriately  reduced.  I  Jpdate  Read  Buffer  allows  a  write 
memory  request  to  provide  data  required  by  a  read  request.  If  any  read  request  needs  the 
data  provided  by  the  write  memory  request,  then  the  size  of  the  read  request  will  be 
reduced  appropriately,  and  the  data  is  not  read  from  memory. 

H.  REMOVE  READ  DUPLICATES  AND  WRITE  DUPLICATES 

ARGUMENTS 

Removing  read  and  write  duplicates  means  that  requests  that  have  intersecting  or 
concurrent  data  will  get  spliced  together  into  one  request.  Otherwise,  a  buffer  may  contain 
multiple  requests  to  the  same  memory  location. 

I.  PRIORITY  ARGUMENTS 

In  SACS,  the  user  specifies  the  priority  of  requests.  The  lowest  numbers  represent 
the  highest  priority.  This  allows  the  designer  to  simulate  a  cache  that  must  finish  all  writes 
before  starting  a  read.  It  also  allows  the  designer  to  delay  reads  for  write  allocated  blocks, 
and  the  writing  of  dirty  blocks 
.1.  SACS  CONTROL  ARGUMENTS 

1.  Introduction 

SACS  has  control  arguments  that  allow  the  user  to  select  one  of  several 
modes  of  operation. 
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2. 


Trace  Argument 


The  trace  mode  permits  the  user  to  step  through  a  trace,  one  clock  cycle  at  a 
rime,  viewing  the  contents  of  the  cache  and  buffers,  and  obtain  statistical  results. 

3.  Check  Argument 

When  SACS  is  in  the  check  mode,  it  performs  a  self  check  of  all  of  its 
global  variables.  These  checks  include  checking  to  see  that  all  the  global  variables  that 
should  remain  constant,  do  in  fact  remain  constant.  Global  variables  that  are  not  constant 
are  checked  to  see  that  they  are  within  prescribed  bounds.  This  form  of  checking  can  occur 
while  the  program  is  in  any  other  mode  (i.e..  Trace,  Test,  or  Key  Board  I/O)  This  check 
can  be  performed  during  normal  data  runs.  This  kind  of  checking  helps  to  identify  errors 
that  might  have  gone  unnoticed.  It  also  assures  the  user  that  the  program  did  not 
catastrophically  fail  during  a  run. 

4.  Test  Argument 

When  SACS  is  in  its  test  mode  it  can  do  nothing  else.  It  will  automatically 
generate  its  own  input  data  The  data  is  generated  by  randomly  selecting  a  finite  number  of 
test  cases  to  use.  Each  test  case  has  a  combination  of  seven  ioad/store  instructions.  The 
expected  number  of  read  and  write  hits  for  each  test  case  is  known.  Therefore,  the  total 
number  of  read  and  write  hits  for  the  trace  can  be  determined.  The  actual  addresses  used 
for  each  test  case  are  chosen  randomly.  However,  all  the  loads  for  a  particular  test  case 
will  map  to  the  same  block.  Similarly,  all  stores  will  also  map  to  the  same  block.  SACS 
will  randomly  select  its  own  set  of  input  parameters,  ignoring  any  other  arguments  entered. 
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It  will  then  run  the  main  routine  on  the  test  trace  as  if  it  was  a  user  defined  file.  Once  the 


trace  is  complete,  SACS  will  compare  the  results  with  what  it  expected  from  the  random 
trace.  If  no  errors  have  been  detected,  then  SACS  will  repeat  the  process  of  randomly 
generating  its  input  file  and  input  parameters  The  test  mode  places  SACS  into  an  infinite 
testing  loop.  The  only  way  to  terminate  the  process  is  to  kill  the  process  The  decision  not 
to  give  the  user  a  more  graceful  way  out  of  the  test  mode  was  made  because  C  does  not 
provide  a  way  to  trap  10.  While  there  are  operating  system  methods  of  trapping  10,  they 
would  have  made  the  program  system  dependent  and,  therefore,  non-portable.  The  current 
version  of  SACS  has  been  compiled  and  run  on  both  a  PC  running  DOS  and  a  SPARC 
station  running  Sun  -OS  without  any  changes  to  die  source  code. 

5.  Key  Board  lO  Argument 

SACS  normally  accepts  its  inputs  from  a  data  file.  However,  it  can  accept 
inputs  directly  from  the  user.  This  input  mode  can  be  used  with  the  trace  and  checking 
modes  if  desired.  SACS  will  ask  for  each  request  from  the  terminal  as  required  The  trace 
display  will  appear  each  time  a  new  request  is  made.  However,  it  will  not  stop  every  clock 
cycle  unless  the  user  selects  the  trace  mode. 

6.  Data  File  Name  Argument 

SACS  normally  assumes  that  the  data  file  is  named  "SACS.Dat",  however 
the  user  can  specify  the  name  of  the  file  he  or  she  wishes  to  trace  using  the  data  file  name 
argument. 
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7.  Histogram  Max.  Index  Arguments 

SACS  provides  the  user  with  two  timing  histograms.  One  provides  timing 
analysis  for  read  and  write  requests.  The  first  histogram  illustrates  how  many  requests 
were  completed  during  the  designated  time.  The  second  histogram  provides  timing 
analysis  for  the  number  of  times  the  cache  waited  to  complete  a  particular  task  in  the 
designated  time.  The  maximum  index  for  these  histograms  is  the  maximum  number  of 
time  bins.  Since  there  may  be  data  out  of  the  maximum  index  range,  the  last  bin  is  used  to 
total  all  events  with  times  greater  than  or  equal  to  the  maximum  index.  The  screen 
histogram  maximum  index  is  the  number  used  for  screen  displays.  The  screen  maximum 
histogram  index  has  a  default  value  of  4,  which  allows  all  displays  to  fit  on  a  standard  80 
column  screen.  However,  if  a  Unix  window  is  available,  the  designer  may  want  tc  raise 
this  number  to  get  more  detailed  displays.  The  file  histogram  maximum  index  is  used  for 
the  output  file  generated  by  SACS.  This  file  may  have  a  much  larger  range  because  it  does 
not  have  to  be  pnnted  on  a  screen.  The  output  file  is  compatible  with  MATLAB  script 
files.  This  allows  results  to  be  read  and  processed  by  MATLAB  for  statistical  analysis  and 
plotting  purposes. 
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IV.  SACS  DISPLAYS 


A.  TRACE  DISPLAY 
1.  Introduction 

SACS  includes  a  trace  mode  that  allows  users  to  monitor  the  behavior  of  the 
simulalod  cache  and  the  implemented  policies  and  scoreboarding  techniques.  The  user 
may  also  need  to  debug  any  modifications  made  to  SACS.  The  trace  mode  is  also  very 
useful  in  identifying  any  programming  errors.  The  trace  mode  allows  the  designer  to 
review  the  status  of  the  cache  at  the  end  of  each  clock  cycle.  A  trace  display  is  shown  in 
Figure  2. 


Currant  lUK^uast: 

Baad 

Tiaas; 

46 

Addrasa: 

2AF769F9 

Haxt  Raquast  Tina: 

49 

Sira; 

07 

TOA: 

49 

Cacha  Waiting  For; 
Haagory  Waiting  For: 

Raad  Manory  Raguast 
Manory  Raad  Aecaas 

Cacha  Hit: 

No 

Block  Waiting  For: 

Mamory  Block  Transfer 

Buffer  Hit: 

No 

Sat  Block 

Address 

V/D  V/D 

V/D 

V/D 

00031  00124 

25B379F0 

0 

0  0 

0 

0  0 

1  0 

00125 

2AF769F0 

0 

0  0 

0 

0  0 

0  0 

00126 

00000000 

0 

0  0 

0 

0  0 

0  0 

00127 

00000000 

0 

0  0 

0 

0  0 

0  0 

Raad  Buffer 

Address 

Size 

Reg. 

Block 

Priority 

Tina  Reg. 

Coup. 

Time 

2AF769F9 

16 

07 

00125 

00 

7 

53 

Write  Buffer 

Address 

Size 

Reg. 

Block 

Priority 

Tima  Rag. 

Coup. 

Tinte 

25B37A10 

10 

00 

00000 

11 

5 

58 

Block  Buffer 

Address 

Size 

Rag. 

Block 

Priority 

Time  Reg. 

Conp. 

Tims 

2Ar;69FB 

00 

00 

00125 

00 

7 

53 

Next  Coimand 

Please  ( 

T, 

Ra  S, 

C,  G 

#.  #,  -#, 

Help]  »>□ 

Figure  2  Trace  Display 
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Curr  -'t  Request  Fields 


The  trace  display  contains  the  last  CPU  request,  as  well  as  the  request 
address  and  size.  SACS  can  only  process  requests  that  are  contained  within  the  same 
block  If  a  request  spans  across  two  or  more  blocks,  then  the  request  is  split  up  into  block 
size  requests  and  processed  separately. 

3.  Cache  Waiting  For  Field 

Whatever  is  holding  up  the  last  CPU  request  is  shown  in  the  Cache  Waiting 
For  field.  In  Table  2,  we  can  see  all  the  things  that  the  cache  might  have  to  wait  for.  If  the 
cache  is  waiting  for  nothing,  then  the  request  has  been  satisfied  If  the  cache  is  waiting  for 
a  read  or  write  cache  request,  then  the  cache  is  being  accessed.  If  the  cache  is  waiting  for  a 
memory  request,  then  some  part  of  the  request  must  be  retrieved  from  memory  and  the 
data  is  not  available.  If  the  request  can  not  proceed  because  one  of  the  buffers  is  full,  then 
Cache  Wailing  For  will  indicate  whether  the  request  is  waiting  for  the  full  read  buffer  or 
the  full  write  buffer.  Note  that  a  read  miss  request  may  have  to  wait  for  dirty  blocks  to  be 
written  to  memory,  making  it  possible  for  a  read  request  to  wait  on  a  full  write  buffer. 

4.  Memory  Waiting  For  Field 

Memory  Waiting  For  identifies  which  memory  function  is  in  progress. 

When  a  new  memory  access  begins.  Memory  Waiting  For  indicates  whether  it  is  a  memory 
read  request  or  a  memory  write  request.  Once  the  access  of  the  first  word  is  in  progress, 
then  Memory  Waiting  For  will  indicate  either  read  access  or  write  access.  However,  once 
the  first  word  has  been  received,  then  Memory  Waiting  For  will  switch  to  indicate  either  a 
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read  transfer  or  a  write  transfer.  If  a  memory  read  request  needs  to  begin  and  the  block 
buffer  is  busy  because  it  has  not  updated  the  cache  from  the  last  request,  then  Memory 
Wailing  For  will  indicate  cache  update. 

5.  Block  Waiting  For  Field 

Block  Waiting  For  describes  what  the  block  buffer  is  doing.  It  will  indicate 
memory  block  transfer  when  a  memory  read  access  or  transfer  is  in  progress.  However, 
once  the  transfer  is  complete,  the  block  buffer  must  update  the  cache  If  the  cache  is  busy, 
then  Block  Waiting  For  will  indicate  that  it's  waiting  for  cache  access.  When  the  cache  is 
not  busy  and  the  cache  update  begins,  then  Block  Waitiny,  For  will  switch  to  indicate  block 
cache  transfer. 


TABLE  2. 

WAIT  FOR  CONDITIONS 

Cache 

Wait  For  Conditions 

Memory 

Wait  For  Conditions 

Block  Buffer 

Wait  For  Conditions 

Nothing 

Read  Cache  Request 

Read  Memory  Request 

Write  Cache  Request 

Write  Memory  Request 

Full  Read  Buffer 

Full  Write  Buffer 

CPU  Cache  Access 

Nothing 

Memory  Read  Request 
Memory  Read  Transfer 
Memory  Write  Request 
Memory  Write  Access 
Memory  Write  Transfer 
Cache  Update 

Nothing 

Memory  Block  Transfer 
Block  Cache  Access 
Block  Cache  Transfer 

6.  Timing  Data  Fields 

The  trace  display  shown  in  Figure  2  includes  a  time  field  that  indicates  how 
many  clock  cycles  have  passed  since  the  start  of  the  run  The  Next  Request  Time  is  the 
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time  at  which  the  CPU  either  has,  or  will  make,  another  request.  The  TO  A  field  indicates 


when  the  next  memory  word  will  arrive  into  the  Block  Buffer.  However,  if  a  write  was  in 
progress,  this  field  would  be  a  TOD  field,  and  would  indicate  the  time  that  the  next  word 
will  leave  the  Write  Buffer. 

7.  Cache  Hit  and  Buffer  Hit  Fields 

The  cache  hit  field  indicates  whether  a  request  is  a  hit  or  not.  The  buffer  hit 
for  a  read  request  indicates  whether  the  data  requested  is  in  the  Block  Buffer  A  buffer  hit 
for  a  write  request  indicates  that  the  Write  Buffer  needed  to  write  the  data  to  memory 
anyway.  A  buffer  hit  will  only  occur  during  a  cache  miss.  Buffer  hits  allow  the  designer  to 
determine  how  many  times  the  scoreboarding  was  used  during  a  run  to  avoid  a  memory 
access  However,  the  true  measurement  of  a  cache’s  performance  is  its  average  access 
time 

8.  Address  Block  Selection  Display 

During  a  trace  run  it  is  helpful  to  see  the  cache  set  that  the  request  address 
got  mapped  to.  This  includes  all  the  blocks  that  the  cache  had  to  work  with  to  satisfy  the 
request.  If  the  request  is  a  hit,  the  block  that  it  hit  on  has  to  be  in  this  set  If  a  block  victim 
is  chosen,  it  has  to  be  chosen  from  this  set 

9.  Buffer  Displays 

fhe  contents  of  all  the  buffers  are  displayed  so  that  the  designer  may  see 
what  the  memory  is  working  on  The  Request  Size  is  the  number  of  bytes  that  have  to  be 
read  in  order  for  the  current  request  to  have  all  the  data  originally  asked  for  This  number 
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might  be  reduced  from  the  original  request  size  if  part  of  the  data  is  m  the  cache  or  if  Block 
Buffer  is  allowed  to  contribute  data  to  the  request  Dunng  the  trace,  the  address,  size,  and 
request  size  will  constantly  change  as  CPU  requests,  and  memory  accesses  and  transfers, 
are  made  The  block  field  indicates  which  cache  block  the  read  data  will  be  placed  in.  The 
pnonty  field  indicates  the  prionty  of  the  memory  request.  A  zero  priority  indicates  that  the 
request  is  in  progress  The  next  lowest  number  will  be  serviced  next,  unless  a  new 
memory  request  is  made  If  more  than  one  request  has  the  same  prionty  number,  then  the 
read  buffer  will  take  pnonty  If  the  read  buffer  has  more  than  one  request  with  the  same 
prioriy,  then  the  pnonty  will  switch  to  FIFO 

10.  Time  Required  and  Completion  Time  Fields 

Every  memory  request  has  a  Time  Required  to  complete  and  a  ('ompletion 
Time  The  Time  Required  to  complete  is  the  time  that  memory  will  have  to  service  the 
request  The  Completion  Time  is  the  time  that  the  request  is  expected  to  be  removed  from 
the  buffer 

1 1.  Next  Command  Please 

The  next  command  line  includes  a  prompt  for  the  user  of  all  the  available 
commands  Shown  in  Table  3  is  a  list  of  all  the  commands  In  the  following  paragraphs, 
these  commands  are  discussed  in  detail 
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TABLE  3. 

TRACE  COMMANDS 


Trace  Displt^  (T) 
Results  Display  (R) 

Stall  Timing  Display  (S) 
Cache  Arguments  Display  (C) 
Go  To  A  Specific  Time  (G  #) 
Increment  Time  (U) 
Decrement  Time  (-#) 
Help  (H) 


B.  RESULTS  DISPLAY 

The  Results  Display,  shown  in  Figure  2,  provides  the  user  with  the  number  of 
requests,  cache  hits,  and  buffer  hits  The  hit  rates  are  a  combination  of  both  the  cache  hits 
and  the  buffer  hits  The  Request  Time  Histogram  gives  the  number  of  requests  that  were 
completed  in  the  prescribed  time.  The  total  amount  of  time  spent  on  each  request,  and  the 
average  access  times,  are  also  displayed.  As  discussed  previously,  the  average  access  time 


is  the  ultimate  measure  of  cache  performance. 
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Figure  3  Results  Display 


C.  STALL  DISPLAY 

The  stall  display  provides  the  designer  with  an  exact  account  of  where  the  cache 


spent  all  its  time.  As  shown  in  Figure  4,  the  stall  time  histogram  lists  all  the  events  that  the 


cache  has  ever  waited  for,  and  the  number  of  times  that  the  cache  waited  for  an  event 


within  a  designated  period. 
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D.  CACHE  ARGUMENTS  DISPLAY 

The  cache  arguments  display  allows  the  user  to  review  the  arguments  used  by  th** 
simulator.  Figure  5  shows  an  example  of  the  cache  arguments  display. 
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Figure  5  Cache  Arguments  Display 

E.  GOTO  A  SPECIFIC  TIME 

Because  data  traces  are  usually  very  long,  SACS  was  given  the  ability  to  run  to  a 
specific  time.  This  allows  the  user  to  begin  a  long  trace  and  inspect  the  results  after  a 
reasonable  amount  of  time  If  the  user  is  debugging  SACS  because  of  a  modification  or, 
God  forbid,  there  is  an  original  error  in  SACS,  this  command  will  allow  the  user  to  advance 
to  the  last  time  the  error  occurred.  If  the  time  specified  is  earlier  than  the  current  time,  then 
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SACS  will  temporally  turn  off  the  trace,  restart  the  run  from  the  beginning,  and  stop  at  the 
desired  time.  Once  SACS  is  at  the  desired  time,  it  will  turn  the  trace  mode  back  on.  To  the 
user,  it  will  appear  that  SACS  went  backwards.  However,  in  fact,  SACS  can  not  run  its 
simulations  in  reverse.  Obviously,  if  the  Desired  Time  is  vary  large,  then  this  process 
could  take  a  great  deal  of  time. 

F.  INCREMENT  TIME 

Increment  time  allows  the  user  to  adjust  the  time  using  a  relative  step  size  instead 
of  an  absolute  desired  time. 

G.  DECREMENT  TIME 

Decrement  time  allows  the  user  to  adjust  the  time  using  a  relative  step  size  instead 
of  an  absolute  desired  time.  Again,  SACS  must  restart  the  run  from  the  beginning  to  stop 
at  the  desired  time. 

H.  HELP  DISPLAY 

The  help  menu,  shown  in  Figure  5,  gives  the  user  simple  descriptions  of  what  all 
the  trace  commands  can  do. 
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Halp  Maftu 
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CR]  Rasulta  Display 

Displays  a  braak  down  of  raad  and  write  cache  hits,  and 
buffer  hits.  Including  a  timing  analysis. 

13]  Stall  Tladng  Display: 

Displays  histogram  of  the  time  spent  on  aaeh  stall. 
Stalls  represent  time  delays  In  coapletlng  a  request. 

[C]  Cache  Arguments  Display; 

Display  Input  arguawnta  to  SACS. 

tS]  Go:  Go  to  end  of  mm. 

[O  *]  Go  To:  Go  to  Tis»  *. 
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CHI  Help:  Displays  this  help  menu. 
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Figure  5  Help  Display 
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V.  SACS  DESIGN 


A.  OVERALL  STRUCTURE  OF  SACS 

SACS  simulates  all  events  one  clock  cycle  at  a  time  using  a  global  variable  named 
Time.  Normally,  it  is  preferable  to  perform  timing  simulations  using  event  queues  so  that 
time  can  advance  to  the  next  event.  However,  in  most  cache  simulations,  so  many  events 
happen  in  one  clock  cycle  that  an  event  queue  would  probably  not  improve  the  performance 
of  the  simulator. 

B.  MAIN  EVENT  LOOP 

In  the  main  event  loop  of  SACS,  Time  is  incremented  one  clock  cycle  at  a  time. 

Time  is  never  changed  by  any  other  procedure  The  requests  are  entered  into  the 
simulation  from  Get  Next  Request.  Simulation  of  all  events  is  performed  by  the  Main 
Event  Loop  calling  Cache  Model,  Memory  Model,  and  I  Ipdate  Cache. 

SACS  insures  that  all  events  that  can  be  started  during  a  particular  clock  cycle  are 
started,  and  that  all  events  that  can  complete  during  a  particular  clock  cycle  do.  CPU 
accesses  to  the  cache  are  given  priority  over  the  block  buffer  cache  updates. 

SACS's  main  loop  includes  the  source  code  to  control  testing,  checking,  and 
tracing.  The  Desired  Time  variable  is  controlled  entirely  by  the  Main  Event  Loop.  Desired 
Time  represents  a  user  request  to  advance  the  simulation  to  a  particular  time  with  the  trace 
off.  SACS  can  not  run  Time  backwards.  However,  if  the  Desired  Time  is  less  than  Time, 
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then  Time  is  reset  back  to  zero  and  the  run  is  repeated  up  to  the  Desired  Time.  The  user 
can  make  time  requests  using  arguments  "G  #".  or 

Throughout  Main  Event  Loop,  Cache  Waiting  For  is  checked  to  see  if  it's  equal  to 
Nothing.  This  indicates  that  the  last  request  has  been  serviced  and  that  the  cache  is  ready 
for  the  next  request.  The  procedures  that  model  specific  events  as  Read  Hit,  Read  Miss, 
and  Access  Cache  are  called  repeatedly  during  their  simulations.  They  utilize  Cache 
Waiting  For  and  Time  to  determine  what  to  do  next.  If  any  of  these  procedures  need  to 
wait  for  a  period,  either  to  simulate  an  access  or  because  a  resource  is  not  available,  then 
they  will  set  Cache  Waiting  For  to  the  appropriate  value.  The  modeling  procedures  in 
Memory  Model  work  the  same  way  using  Memory  Waiting  For. 

Whenever  SACS  finds  an  error  or  a  discrepancy  then  the  boolean  variable 
Discrepancy  Found  is  set  to  Yes.  This  forces  SACS  into  a  trace  mode  so  that  the  user  may 
try  to  identify  the  cause  of  the  error.  In  test  mode,  a  discrepancy  forces  SACS  out  of  test 
mode  so  that  the  trace  file  that  caused  the  error  is  not  erased  by  a  new  file. 

C.  CACHE  IVIODEL 

('ache  Model  makes  all  the  necessary  calls  to  simulate  cache  memory.  Cache 
Model  decides  which  calls  to  make  based  on  the  values  of  Cache  Hit  and  Request.  This 
function  is  called  every  time  Time  is  incremented.  If  there  are  no  read  or  write  requests 
waiting  to  be  completed,  the  function  does  nothing.  The  value  of  Cache  Hit  will  remain 
Unknown  until  the  appropriate  cache  access  time  has  expired  Then,  Cache  Model  will  call 
Is  Request  A  Hit  to  determine  if  the  request  is  a  hit  or  a  miss. 
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1. 


Is  Request  A  Hit 


Is  Request  A  Hit  determines  if  the  request  is  a  hit  or  a  miss,  and  sets  Cache 
Hit  to  the  appropriate  value.  Is  Request  A  Hit  will  find  the  Set  Number  that  the  data  is 
supposed  to  be  in.  Then,  all  Cache  Block  Addresses  in  that  set  will  be  checked  to  see  if 
they  equal  the  Block  Address  for  that  request.  If  the  correct  block  is  found,  then  all  sub 
blocks  that  are  required  to  satisfy  the  request  will  be  inspected  for  validity.  If  they  are  valid 
then  Cache  Hit  will  equal  Yes. 

2.  Read  Hit 

Read  Hit  is  called  to  simulate  a  cache  hit  during  a  read  request.  Read  Hit 
simply  finishes  simulating  the  cache  access  for  the  hit.  Read  Cache  Hit  Time  is  the  time 
required  to  send  the  data  from  the  cache  to  the  CPU.  Note  that  the  time  to  locate  the  block 
in  the  cache  is  simulated  in  Cache  Model.  Read  Hit  is  called  repeatedly  while  Time  is 
incremented  until  Access  Cache  returns  with  Cache  Waiting  For  equal  to  Nothing.  Access 
Cache  will  return  Cache  Waiting  For  equal  to  Read  Cache  Request  until  the  Read  Cache 
Hit  Time  has  expired. 

3.  Read  Miss 

Read  Miss  is  called  to  simulate  a  cache  miss  during  a  read  request.  Read 
Miss  first  simulates  the  time  it  would  take  to  perform  all  the  block  management  for  a  read 
miss.  This  time  is  called  Read  Cache  Miss  Time.  Once  that  time  b'is  expired.  Read  Miss 
will  call  Select  Block  Victim  to  pick  a  block  in  the  set.  When  Select  Block  Victim  returns 
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with  Cache  fVaiting  For  equal  to  Nothing  the  Request  Block  Number  will  contain  the  new 
block  number  where  the  data  will  be  placed. 

Once  the  new  block  has  been  chosen.  Read  Miss  will  call  Add  To  Read 
Buffer.  If  Read  Forward  is  selected,  then  Required  Size  for  the  memory  request  will  be 
equal  to  the  Request  Size.  However,  if  it  is  not,  then  Required  Size  for  the  memory  request 
will  equal  Block  Size.  The  Required  Size  in  read  memory  request  tells  the  Memory  Model 
how  much  of  the  requested  data  must  be  read  into  the  Block  Buffer  before  resetting  Cache 
Waiting  For  back  to  Nothing.  By  setting  Required  Size  equal  to  Block  Size,  Read  Miss  is 
forcing  Memory  Mode!  to  read  in  the  entire  block  before  setting  Cache  Waiting  For  back  to 
Nothing.  Once  the  Memory  Model  has  received  the  data,  it  is  assumed  to  be  available  to 
the  CPU  during  that  clock  cycle. 

4.  Write  Hit 

Write  Hit  is  called  to  simulate  a  cache  hit  during  a  write  request.  Write  Hit 
will  first  simulate  the  time  to  write  the  data  to  the  Request  Block  Number  in  the  cache.  The 
time  to  locate  the  block  was  simulated  by  Cache  Model.  Once  Write  Cache  Hit  Time  has 
expired  then  Write  Hit  will  perform  the  block  management  for  the  request.  The  block 
management  is  dictated  by  the  Write  Policy.  For  a  Write  Back  policy,  the  sub  blocks 
written  to  must  have  their  dirty  bits  set.  This  is  done  by  Set  Dirty  Bit.  For  a  Write 
Through  policy,  the  memory  request  must  be  entered  into  the  write  buffer.  This  is  done  by 
Add  To  Write  Buffer. 
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5. 


Write  Miss 


Write  Miss  is  called  to  simulate  a  cache  miss  during  a  write  request.  Write 
Miss  will  first  simulate  the  time  needed  to  make  all  memory  requests.  This  time  is  called 
Write  Cache  Miss  Time.  This  is  only  the  time  required  to  make  the  requests,  not  the  time 
required  to  complete  them.  The  time  to  determine  that  the  correct  block  was  not  in  the 
cache  memory  was  simulated  by  Cache  Model.  The  memory  requests  are  entered  into  the 
buffers  after  the  Write  Cache  Miss  Time  expires.  The  memory  requests  are  dictated  by  the 
Write  Miss  Policy.  The  simplest  policy  is  Write  Around.  For  a  Write  Around  policy,  the 
write  data  is  placed  in  the  Write  Buffer  by  Add  To  Write  Buffer  Write  Allocate,  however, 
is  the  toughest  simulation  in  SACS  Write  Miss  must  first  choose  a  block  to  put  the  new 
data  in  This  is  done  by  Select  Block  Victim.  Block  data  not  provided  by  the  write  request 
has  to  be  read  in  This  read  request  is  made  by  Add  To  Read  Buffer.  The  read  address  is 
calculated  by  adding  the  request  size  to  the  address.  Because  new  address  may  be  in  the 
next  block,  the  Block  Size  may  have  to  be  subtracted  to  make  the  addition  modulo  Sub 
blocks  that  were  written  to  in  there  entirety  will  have  there  valid  bits  set  to  reflect  the 
presence  of  the  data  provided  by  the  CPU.  However,  if  only  part  of  a  sub  block  was 
written  to,  then  the  Cache  Valid  Bit  will  not  be  set. 

Write  Miss  uses  the  Write  Policy  to  dictate  how  the  write  data  is  to  update 
the  memory.  For  a  Write  Back  policy,  dirty  bits  are  set  by  Set  Dirty  Bits.  For  a  Write 
Through,  the  data  is  added  to  the  Write  Buffer  by  Add  To  Write  Buffer. 
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6. 


Access  Cache 


Access  Cache  is  called  to  simulate  the  CPU  accessing  the  cache.  Access 
Cache  first  waits  for  the  cache  not  to  be  busy.  The  only  reason  it  could  be  busy  is  if  the 
Block  Buffer  is  in  the  process  of  updating  the  cache.  During  this  time.  Access  Cache  will 
return  Cache  Waiting  For  equal  to  CPU  Cache  Access.  Once  the  cache  is  not  busy  then 
Cache  Busy  is  set  to  Yes.  locking  out  the  Block  Buffer  from  accessing  the  cache.  Then, 
Cache  Waiting  For  will  be  set  equal  to  Wailing  For  Request.  This  is  a  local  variable 
passed  by  the  caller.  It  will  either  be  equal  to  Read  Cache  Access  or  Write  Cache  Access. 
Then,  ('ache  Busy  is  set  for  the  time  specified  by  Request  Time.  Request  Time  is  a  local 
variable.  It  could  equal  any  of  the  hit,  miss,  or  access  times.  Once  Request  Time  has 
expired  then  Access  Cache  will  set  ('.ache  Busy  equal  to  No,  and  ('ache  Waiting  For  equal 
to  Nothing. 

7.  Select  Block  Victim 

Select  Block  Victim  chooses  the  next  block  to  be  used  and  writes  the  dirty 
sub  blocks  out  to  the  Write  Buffer.  Select  Block  Victim  first  surveys  the  cache  set  that  the 
Request  Address  maps  to.  The  survey  includes  finding  the  block  that  was  least  recently 
accessed.  This  Block  Number  is  stored  in  LRUBlock.  Once  the  set  has  been  surveyed  then 
the  Replacement  Policy  dictates  how  the  block  is  chosen.  For  the  LRU  policy.  Request 
Block  Number  is  set  equal  to  LR( (Block.  For  the  FIFO  policy,  ('ache  Next  Block  keeps 
track  of  the  next  victim  block  for  each  set.  ('ache  Next  Block  is  initialized  to  all  zeros 
during  the  beginning  of  a  run.  Therefore,  it  must  be  checked  to  see  if  it  is  between  the  first 
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and  last  blocks  for  the  set.  If  it  is  not,  then  Cache  Next  Block  for  Set  Number  is  reset  to 


First  Block.  Once  Seleci  Block  Victim  knows  it  has  a  valid  Cache  Next  Block  then  RCi^uest 
Block  is  set  equal  to  it.  Then,  Cache  Next  Block  for  the  Set  Number  is  incremented.  For 
RAND  policy,  the  block  number  is  chosen  randomly  from  all  the  blocks  in  the  set. 

Select  Block  Victim  writes  all  dirty  sub  blocks  to  the  write  buffer  using  Write  Dirty 
Sub  Blocks.  Write  Dirty  Sub  Blocks  takes  care  of  clearing  the  dirty  and  valid  bits  in  the 
block.  Once  Select  Block  Victim  is  called  and  it  gets  to  the  bottom  of  the  function  with 
Cache  Waiting  For  equal  to  Nothing,  then  the  Cache  Block  Address  for  the  Request  Block 
Number  is  set  equal  to  the  block  address  of  Request  Address. 

8.  Set  Dirty  Bits 

Set  Dirty  Bits  sets  the  dirty  bits  for  all  sub  blocks  that  contain  data  that  was 
modified  by  a  write  request. 

9.  Write  Dirty  Sub  Blocks 

Write  Dirty  Sub  Blocks  is  called  to  simulate  writing  all  the  dirty  sub  blocks 
in  the  Request  Block.  Write  Dirty  Sub  Blocks  not  only  clears  all  the  dirty  bits,  it  also  clears 
all  the  valid  bits  Write  Dirty  Sub  Blocks  prepares  a  block  to  receive  new  data,  and  is 
called  after  a  block  has  been  selected  as  a  victim.  Write  Dirty  Sub  Blocks  will  search  the 
block  for  consecutive  dirty  blocks  and  splice  them  together  into  one  write  request.  The 
write  request  is  then  added  to  the  Write  Buffer.  All  of  the  sub  blocks  that  make  up  the 
request  will  have  their  dirty  and  valid  bits  cleared  This  process  of  searching  and  writing  is 
repeated  until  all  the  bits  are  not  dirty.  Then,  all  the  valid  bits  are  cleared. 
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10.  Add  To  Read  BufTer 


Add  To  Read  Buffer  takes  the  elements  of  a  request  and  adds  the  request  to 
the  Read  Buffer.  It  will  perform  all  of  the  searches  and  updates  necessary  to  support  the 
appropriate  scoreboarding  protocols. 

Add  To  Read  Buffer  will  begin  by  searching  the  cache  and  Block  Buffer  for 
each  byte  in  the  request,  starting  at  the  beginning  of  the  request.  Every  time  a  byte  is  found 
in  one  or  the  other,  the  Address  is  incremented  while  Size  and  Required  Size  are 
decremented.  This  simulates  removing  the  available  data  from  the  front  of  the  request. 
Then,  Add  To  Read  Buffer  will  search  the  cache  and  Block  Buffer  for  the  data  at  the  end  of 
the  request.  Every  time  a  byte  is  found,  the  Size  of  the  request  is  decremented  by  one.  If 
the  byte  was  a  required  byte  then  the  Required  Size  is  also  decremented.  This  simulates 
removing  any  data  available  from  the  end  of  the  request.  Add  To  Read  Buffer  is  either  left 
with  a  request  that  has  a  Size  equal  to  zero  or  the  end  points  are  both  needed  from  memory. 
If  the  Required  Size  is  zero  then  the  request  is  a  buffer  hit,  otherwise  the  request  is  a  buffer 
miss.  If  the  request  is  already  a  cache  hit  then  the  buffer  hit  is  for  some  block  management 
request.  These  kinds  of  buffer  hits  are  not  recorded  because  it  would  confuse  the  Results 
Display  by  making  it  possible  to  get  a  hit  rate  greater  than  100%.  If  the  Size  is  not  zero 
and  Remove  Read  Duplicates  is  equal  to  No  then  the  request  is  added  to  the  end  of  the 
Read  Buffer  using  Append.  Append  is  a  buffer  utility  that  adds  the  request  to  the  end  of  the 
buffer  The  request  must  be  added  to  the  end  of  the  buffer  in  order  not  to  interfere  with 
Memory  Model,  which  may  be  in  the  middle  of  a  memory  read.  If  Remove  Read 
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Duplicates  is  equal  to  Yes  then  the  first  byte  in  the  request  will  be  spliced  into  the  Read 
Buffer 

Splice  is  another  buffer  utility.  Splice  will  first  search  the  Read  Buffer  for  the  byte 
If  it  can't  find  a  request  in  the  buffer  that  contains  the  byte  then  it  will  search  for  a  memory 
request  that  is  getting  data  from  the  same  block  If  one  is  found  then  the  request  is 
modified  to  include  the  new  read  byte  request.  If  no  suitable  request  can  be  found  then 
Splice  will  add  a  one  byte  request  to  the  Read  Buffer.  The  Address  is  then  incremented 
while  Size  and  Required  Size  are  decremented  Then,  the  cache  and  Block  Buffer  are 
searched  for  the  next  byte  If  it  is  not  found  then  the  next  byte  is  spliced  into  the  Read 
Buffer.  This  process  is  repeated  until  all  of  the  bytes  of  the  request  have  either  been  spliced 
into  the  Read  Buffer  or  found. 

The  Buffer  Hit  is  normally  defined  as  when  the  data  is  available  but  not  in  the 
cache.  However,  in  order  to  support  the  testing  of  SACS,  the  definition  of  a  buffer  hit  is 
revised  to  mean  that  a  request  was  found  to  have  accrued  recently,  and  tnat  given  time  to 
complete  all  block  management  requested  data  would  have  been  in  the  cache.  This  allows 
Test  SA(  'S  to  predict  the  hits  of  a  test  run  without  taking  into  account  the  time  it  takes  to 
perform  the  block  management 

Every  time  a  request  is  spliced  into  the  read  or  write  buffers,  the  Time  To  Execute 
and  Completion  Time  Estimate  must  be  recalculated.  The  new  time  estimates  are 
performed  by  Calculate  Time  Estimates 
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11.  Search  Cache 


Search  Cache  is  called  by  Add  To  Read  Buffer  to  find  any  parts  of  the 
request  that  may  already  be  located  in  the  cache.  This  must  be  done  because  if  a  read 
request  follows  a  write  request  using  a  write  allocate  policy,  then  part  of  the  read  may  be  in 
the  cache  while  the  rest  may  still  need  to  be  read  from  memory.  Search  Cache  checks  all 
('ache  Block  Addresses  in  the  cache  set.  If  any  of  the  cache  block  addresses  equal  the 
block  address  of  the  byte,  then  Search  ('ache  checks  the  Cache  Valid  Bit  for  the  sub  block 
that  the  byte  is  located  in.  If  the  sub  block  is  valid  then  Search  Cache  returns  Yes. 

12.  Add  To  Write  Buffer 

Add  To  Write  Buffer  adds  one  record  to  the  write  buffer.  It  also  updates  the 
Read  Buffer  if  the  I  Update  Read  Buffer  argument  is  asserted.  The  process  of  updating  the 
Read  Buffer  is  simply  changing  the  requests  so  that  data  made  available  by  the  write 
request  is  not  requested  from  memory.  Update  Read  Buffer  should  not  be  used  unless  the 
word  and  sub  block  sizes  are  equal.  This  is  because  a  write  request  may  reduce  a  read 
request  to  where  the  read  request  will  not  be  large  enough  to  validate  a  sub  block.  The 
wnte  request  may  also  be  unable  to  set  any  valid  bits  because  of  sub  block  alignment  The 
result  is  that  a  sub  block  that  was  suppose  to  be  read  in  is  not 
D.  MEMORY  MODEL 

Memory  Model  makes  all  the  necessary  calls  to  simulate  main  memory.  Memory 
Model  decides  which  calls  to  make  based  on  Memory  Waiting  For.  This  function  is  called 
every  time  Time  is  incremented.  If  there  are  no  read  or  wnte  requests  waiting  to  be 
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completed,  the  function  does  nothing.  Memory  Model  contains  a  loop  that  forces  the 
procedure  to  continue  modeling  until  TOA  and  TOD  are  not  equal  to  Time.  This  insures 
that  if  there  are  any  events  that  occur  in  zero  clock  cycles  then  the  next  event  is  allowed  to 
start 

Memory  Model  calls  Select  Memory  Request  to  choose  a  request  from  either  the 
read  or  the  write  buffers.  Memory  Model  calls  Start  Reads  and  Start  Writes  to  simulate 
accessing  memory  and  receiving  the  first  word  of  a  memory  request.  Continue  Reads  and 
Continue  Writes  are  then  called  to  simulate  the  memory  transfer  of  the  following  words  of 
data 

1.  Select  Memory  Request 

Select  Memory  Request  is  called  when  memory  is  waiting  for  nothing. 
Select  Memory  Request  chooses  a  request  from  either  the  read  or  write  buffers  based  on 
priority.  The  request  is  not  returned  however,  and  the  request  is  left  at  the  top  of  the  buffer 
with  its  Priority  set  to  zeros  and  Access  In  Progress  set  equal  to  Yes.  If  a  request  is  found, 
then  Memory  Waiting  For  is  set  to  Memory  Read  Request  or  Memory  Write  Request. 
depending  on  whether  the  request  was  found  in  the  read  or  write  buffer. 

2.  Start  Reads 

Start  Reads  begins  a  read  request,  simulating  the  first  word  read  from 
memory  The  time  to  complete  this  read  is  called  Memory  Acce.?s  Time.  The  Block  Buffer 
is  initialized  in  preparation  to  receive  the  new  data  words.  If  Block  Waiting  For  is  not 
equal  to  Nothing  then  Start  Reads  will  have  to  wait  before  allowing  the  new  memory  read 
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request  to  start.  \f  Start  Reads  does  have  to  wait  for  the  cache  then  Memory  Waiting  For  is 
set  equal  to  Cache  Update,  otherwise  Memory  Waiting  For  is  set  to  Memory  Read  Access. 
The  new  block  record  is  equal  to  the  Read  Buffer  with  its  sizes  set  to  zero.  This  gives  the 
Block  Memory  Request  the  same  block  number  as  the  Read  Memory  Request.  The 
Address  is  aligned  to  Word  Size.  The  Address  must  be  aligned  because  the  words  read  in 
will  be  aligned  to  Word  Size.  The  new  Block  Memory  Request  is  simply  pushed  onto  the 
Block  Buffer.  Block  Waiting  For  is  set  equal  to  Memory  Block  Transfer  to  indicate  that 
data  is  being  transferred  from  memory  to  the  Block  Buffer. 

3.  Continue  Reads 

Continue  Memory  Reads  continues  the  memory  read  request  started  by 
Start  Memoty  Reads.  It  simulates  every  read  from  memory  other  than  the  first  word, 
which  is  simulated  by  Start  Memory  Reads.  The  time  to  complete  each  word  transfer  is 
equal  to  Memory  Transfer  Time.  The  block  and  read  buffers  are  altered  every  time  a  word 
is  read  from  memory  Once  a  request  is  complete,  it  is  removed  from  the  Read  Buffer  and 
Memoty  Waiting  For  is  reset  to  Nothing.  Block  Waiting  For  is  set  to  Block  Cache  Access 
in  preparation  to  transfer  the  new  data  to  the  cache.  If  the  (  ompletion  Time  Estimate  for 
the  memory  read  request  is  not  equal  to  Time  then  a  time  prediction  error  is  raised. 

4.  Start  IMemory  Writes 

Start  Memory  Writes  begins  a  memory  write  request,  simulating  the  first 
word  written  to  memory.  The  time  to  complete  this  one  word  write  is  called  Memory 
Access  Time.  Memory  Waiting  For  is  set  lo  Memoty  Write  Access 
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5. 


Continue  Memory  Writes 


Continue  Memory  Writes  continues  the  memory  write  request  started  by 
Start  Memory  Writes.  Like  Continue  Memory  Reads,  it  simulates  every  write  to  memory 
other  than  the  first  word,  which  is  simulated  by  Start  Memory  Writes.  The  time  to 
complete  each  word  transfer  is  equal  to  Memory  Transfer  Time  The  Write  Buffer  is 
altered  every  time  a  word  is  written  to  memory.  Once  the  memory  write  request  is 
complete,  it  is  removed  from  the  Write  Buffer,  and  Memory  Waiting  For  is  reset  to 
Nothing.  If  the  Completion  Time  Estimate  for  the  memory  read  request  is  not  equal  to 
Time  when  the  request  is  completed  then  a  time  prediction  error  is  raised. 

6.  Update  Cache 

( Ipdate  Cache  simulates  entering  data  form  the  Block  Buffer  into  the  cache 
I  Ipdate  Cache  first  checks  whether  or  not  the  cache  is  busy.  If  it  is  not,  then  Cache  Busy  is 
asserted  and  Block  Waiting  For  is  set  equal  to  Block  Cache  Transfer.  The  Block  TO  A  is 
calculated  to  enable  Calculate  Time  Estimates  to  predict  the  completion  times  for 
additional  memory  read  requests  in  the  buffer.  If  the  cache  is  busy  then  the  previous 
memory  request  time  completions  may  be  wrong.  That  is  because  all  of  the  last  estimates 
counted  on  the  old  Block  TOA.  Therefore  they  all  must  be  recalculated. 

Once  the  Buffer  Cache  Access  Time  has  expired  then  Block  Waiting  For  is 
set  equal  to  Nothing  and  the  Cache  Busy  is  deasserted.  The  read  data  must  then  be 
removed  from  the  Block  Buffer.  The  appropriate  sub  blocks  in  the  cache  will  then  have 
their  dirty  bits  cleared  and  valid  bits  set 
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7.  Add  A  Word  To  Memory  Request 

Add  A  Word  To  Memory  Request  adds  a  word  to  a  Memory  Request  as  it 
had  been  read  in  from  memory.  The  address  is  first  aligned  to  Word  Size.  Then,  the  size  is 
incremented  by  Word  Size.  This  simulates  the  data  being  added  to  the  request. 

8.  Remove  A  Word  From  Memory  Request 

Remove  A  Word  Form  Memory  Request  removes  a  word  from  a  Memory 
Request  as  if  it  had  been  written  to  memory.  A  copy  of  the  Address  is  first  stored  in  Old 
Address.  Then,  the  Address  is  word  aligned  and  incremented  by  Word  Size.  The  Required 
Size  and  Size  are  then  decremented  by  the  difference  of  the  new  Address  and  the  Old 
Address.  Finally,  if  the  Address  is  outside  the  range  of  the  original  block,  then  Address  is 
decremented  by  Block  Size  to  simulate  modulo  addition  This  simulates  removing  a  word 
from  the  memory  request,  taking  into  account  word  and  block  alignment  constraints. 

E.  TIME  ESTIMATES 

Time  estimates  are  performed  to  provide  a  method  of  testing  Cache  Model,  and 
Memory  Model's  handling  of  the  read  and  write  buffers.  These  two  procedures  are  located 
in  "TimeEst.c" 

1.  Update  Time  To  Execute 

Update  Time  To  Execute  calculates  the  time  to  complete  a  memory  transfer 
given  Memory  Request.  Memory  Request  could  be  a  read  or  write  request  in  a  buffer. 

I  fpdatc  Time  To  Execute  changes  the  Time  To  Execute  field  to  the  new  value.  Time  To 
Execute  is  calculated  by  first  finding  the  number  of  Words  To  Be  Transferred.  If  the 
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Memory  Request  is  not  being  accessed  then  the  Time  To  Execute  is  simply  the  Access  Time 
plus  the  Transfer  Time  multiplied  by  one  less  than  Words  To  Be  Written.  If  the  Memory 
Request  is  in  progress  then  the  new  Time  To  Execute  is  dependent  on  TO  A  or  TOD  of  the 
next  word.  Memory  Waiting  For  dictates  whether  to  use  the  TO  A  or  TOD.  If  Memory 
Waiting  For  is  equal  to  Cache  I Jpdate  then  the  request  has  not  actually  begun  transferring 
data.  Therefore,  the  Time  To  Execute  can  be  calculated  as  if  the  read  request  is  not  in 
progress. 

2.  Calculate  Time  Estimates 

Calculate  Time  Estimates  updates  the  Completion  Time  Estimates  for  each 
request  in  both  the  read  and  write  buffers.  This  function  is  called  whenever  the  Cache 
Model  adds  to  the  read  or  write  buffers.  Calculate  Time  Estimates  must  be  called  every 
time  new  data  is  entered  into  the  buffers.  This  is  because  all  previous  estimates  did  not 
take  into  account  the  new  data  requested.  Calculate  Time  Estimates  first  orders  all  entries 
in  both  the  Read  Buffer  and  the  Write  Buffer  by  priority.  Then,  Calculate  Time  Estimates 
steps  though  both  buffers  simultaneously,  each  time  picking  the  request  that  has  the  highest 
priority  and  adding  the  time  to  execute  to  the  Time  Estimate.  The  Time  Estimate  becomes 
that  requests  Completion  Time  Estimate.  This  process  is  repeated  until  all  requests  have  a 
new  Completion  Time  Estimate.  Time  To  Execute,  for  cache  request,  is  updated  before  it 
is  used  to  calculate  the  Time  Estimate. 
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VI.  PROGRAM  VALIDATION 

A.  TESTING  SACS 

Program  validation  was  considered  to  be  a  paramount  issue  in  designing  and 
implementing  SACS.  The  debugging  techniques  for  SACS  were  engineered  during  the 
early  planning  phases,  before  any  code  was  written.  In  fact,  there  was  a  great  deal  of 
energy  spent  trying  to  make  SACS  a  general  event  simulator.  Not  only  would  this  have 
made  it  easier  for  the  user  to  alter  the  protocols,  but  more  importantly,  it  would  have  been 
easier  to  test  the  program.  It  would  have  been  easier  because  the  number  of  different  kinds 
of  event  transitions  would  have  been  less  than  the  number  of  different  cache  argument 
permutations.  This  method  was  aborted  because  data  that  was  stored  in  the  cache  and  the 
buffers  was  completely  different.  Another  problem  that  plagued  this  method  was  that  the 
scoreboarding  techniques  were  unique  for  each  buffer.  Having  abandoned  the  previous 
method,  and  recognizing  that  SACS  would  have  dozens  of  input  parameters  (  37  to  date),  a 
great  deal  of  concern  developed  over  how  the  program  could  be  tested.  It  was  decided  that 
hand  testing  would  prove  to  be  ineffective  in  eliminating  most  or  all  of  the  programming 
errors.  Therefore,  an  automated  testing  routine  was  developed.  The  testing  routine  was 
incorporated  into  the  source  code  of  SACS  and  can  be  activated  using  the  -tesi  argument. 
When  the  program  is  in  the  test  mode,  it  goes  into  an  infinite  loop  generating 
pseudo-random  load  and  store  instructions.  Each  trace  is  processed  using  the  same  code  as 
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if  the  trace  was  generated  by  a  designer.  Each  time  a  new  trace  run  is  executed,  the  input 
parameters  are  randomized.  This  testing  method  is  the  backbone  of  all  other  validation 
methods  for  SACS.  Other  error  checking  is  performed  during  this  process.  However,  the 
random  trace  and  random  argument  testing  is  the  best  method  to  ensure  that  all  lines  of 
code  in  SACS  get  executed  during  the  test  phase  of  SACS.  This  prevents  SACS  from 
experiencing  a  catastrophic  failure  during  an  actual  simulation  because  almost  all 
instructions  are  executed  during  the  testing  phase.  SACS  tries  to  predict  the  number  of 
read  and  write  hits  for  each  run.  These  predictions  are  compared  to  the  number  of  cache 
and  buffer  hits  if  the  input  arguments  are  expected  to  make  the  cache  and  buffer  hits  reflect 
the  predictions.  An  example  of  when  the  input  arguments  would  make  it  impossible  to 
predict  a  hit  or  a  miss  is  when  the  rand  block  replacement  policy  is  used.  A  block  of  data 
that  has  just  been  read  into  the  cache  may  be  selected  as  a  victim.  This  makes  it  impossible 
to  predict  which  blocks  will  be  in  the  cache  at  the  beginning  of  the  next  request.  Another 
example  is  when  a  read  forward  policy  is  used  and  the  block  buffer  is  not  searched  Data 
expected  to  be  in  the  cache  may  be  in  the  Block  Buffer,  or  in  the  Read  Buffer,  waiting  to 
complete  the  block  transfer  This  requires  that  the  predicted  hits  only  be  compared  when 
the  block  and  read  buffers  are  searched.  It  also  requires  that  during  the  test  mode,  buffer 
hits  will  include  the  read  buffer.  Policies  that  can  not  be  checked  for  predicted  hits  are 
allowed  in  the  test  because  they  can  be  checked  for  other  things  including  the  simple,  yet 
important  requirement  that  the  program  does  not  spontaneously  abort. 
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The  instructions  that  are  randomly  generated  for  a  test  trace  are  seeded  from  64  test 
vectors.  These  test  vectors  each  have  7  read  or  write  instructions.  The  number  of  these 
vectors  to  be  used  to  generate  a  trace  is  randomly  chosen.  The  actual  test  vectors  to  be 
used  are  also  randomly  chosen.  Each  test  vector  is  assigned  a  random  set  of  block 
addresses.  Each  of  the  block  addresses  for  a  particular  test  vector  will  map  to  the  same  set 
in  the  cache.  The  actual  data  address  for  each  request  is  formed  by  taking  the  block 
address  and  adding  a  random  number  such  that  the  data  address  is  still  in  the  same  block. 
The  size  is  also  chosen  randomly  in  such  a  way  that  the  request  does  not  violate  block 
alignment. 

Once  ail  the  test  instructions  have  been  created,  they  are  randomly  shuffled  in  such 
a  way  that  the  final  number  of  hits  and  misses  will  remain  the  same  as  predicted. 

B.  CHECKING  COMPLETION  TIME 

The  timing  analysis  of  SACS  is  so  important  that  it  was  decided  that  every  timing 
test  that  could  be  performed  would  be  performed.  SACS  simulates  events  based  on  the 
current  time  only  because  some  events  can  be  predicted,  such  as  the  time  that  a  buffer 
request  would  be  removed  from  a  buffer.  A  good  timing  test  would  be  to  calculate  the 
estimated  time  of  completion.  Then,  check  to  see  if  that  estimated  time  is  the  same  as  the 
time  that  the  request  is  removed  from  the  buffer.  If  they  do  not  match  then  an  error  is 
indicated.  This  kind  of  error  checking  goes  on  during  every  run  whether  it's  a  test  run  or  a 
user's  run. 
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C.  CHECKING  GLOBAL  VARIABLES 

SACS  uses  82  global  variables.  Approximately  half  of  the  global  variables  are 
constant  during  a  single  run.  These  variables  mostly  represent  input  parameters,  and 
although  they  are  changed  in  between  test  runs,  they  remain  constant  for  the  rest  of  the 
trace  run.  SACS  was  written  in  C,  a  powerful  language  that  permits  the  programmer  to 
create  some  powerfiiJ  and  elusive  bugs.  Specifically,  C  allows  assignments  to  be  buried  in 
logical  expressions.  This  capability  could  easily  result  in  altering  input  parameters  instead 
of  checking  a  parameters  value.  To  avoid  this  kind  of  error  and  others  like  it,  copies  of  all 
constant  global  variables  are  made  before  the  beginning  of  the  trace  run.  At  the  end  of 
every  simulated  clock  cycle  these  variables  are  compared  to  their  original  copies.  If  a 
discrepancy  is  found  then  an  error  is  indicated. 

Global  variables  that  are  not  constant  are  also  inspected.  They  are  inspected  to 
ensure  that  they  are  all  within  acceptable  boundaries.  These  boundaries  are  not  always 
constant.  For  example,  histogram  index  and  total  time  should  always  exceed  Time. 
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VII.  SAMPLE  RUNS 


A.  EXAMPLE  SACS  SIMULATION  RUN 

In  the  first  simulation  run  for  SACS  the  default  parameters  were  used.  This  run 
will  demonstrate  a  write  allocation  miss  and  a  write  through  hit.  This  run  will  also 
demonstrate  a  read  miss  that  takes  advantage  of  removing  duplicates,  and  how  a  write 
request  can  update  the  read  buffer.  Table  4  shows  the  trace  data  used  for  the  simulation 
run. 


Table  4  TRACE  DATA  FOR  RUN 

Typ- 
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X00000104 
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The  Request  Type  is  either  a  read  or  a  write  request.  Read  requests  are  indicated 
with  a  lower  case  "r".  Write  requests  are  indicated  with  a  lower  case  "w"  The  address  is 
read  as  a  long  hexadecimal  integer.  The  Request  Size  is  a  long  unsigned  decimal  integer. 
It  represents  the  size  in  bytes.  Time  I  Inti!  Next  Request  is  the  time  between  when  the 
CPU’s  current  request  is  complete  and  when  the  CPU  makes  the  next  request.  The 
simulation  run  was  performed  by  loading  the  trace  data  from  Table  4  into  an  ASCII  data 
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file  named  "SACS.Dat".  Then,  SACS  was  started  with  the  trace  mode  on.  The  first  trace 


display  that  SACS  produced  is  shown  in  Figure  6. 
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Figure  6  Trace  Display  For  Time=l 


Figure  6  shows  the  status  of  SACS  after  the  first  clock  cycle.  The  Cache  Waiting 
For  field  shows  that  SACS  is  modeling  the  cache  access.  Memory  Waiting  For  is  Nothing 
because  the  cache  does  not  know  if  the  request  is  a  hit  or  a  miss.  Block  Waiting  For  is 
Nothing  because  no  read  requests  have  started.  The  Next  Request  Time  indicates  that  the 
CPU  will  send  another  request  at  Time  equal  to  2.  Cache  Hit  and  Buffer  Hit  are  Unknown 
because  the  cache  block  still  has  not  been  accessed.  The  request  will  be  mapped  to  set 
number  16,  block  64. 
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The  trace  display  for  Time  equal  to  2  is  shown  in  Figure  7.  This  display  shows  that 
the  CPU  has  made  the  second  write  request.  Again,  the  Cache  Waiting  For  indicates  th^t 
the  cache  is  accessing  block  64.  The  Memory  Waiting,  For  indicates  that  memory  is 
accessing  the  first  word  in  memory  for  the  last  write  request.  The  TOD  indicates  that  the 
first  word  will  be  written  to  memory  at  Time  equal  to  5  Cache  and  buffer  hits  are  again 
I  Jnknown  because  block  64  has  not  been  accessed.  The  set  data  indicates  that  the  last  write 
request  at  1 00  validated  the  first  sub  block.  The  Read  Buffer  has  the  remaining  data 
needed  for  block  64.  The  Req.  field  is  the  number  of  bytes  required  to  satisfy  the  CPU 
request  None  are  required  in  this  case  because  the  data  was  only  needed  to  fulfill  a  block 
management  requirement  The  Write  Buffer  shows  the  last  write  request.  It  also  predicts 
that  the  memory  write  request  will  be  complete  at  Time  equal  to  5. 
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Figure  7  Trace  Display  For  Time=2 
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The  next  display  is  for  Time  equal  to  3,  and  is  shown  in  Figure  8  This  display 
shows  that  cache  is  still  working  on  the  last  write  request.  Cache  Waiting  For  still 
indicates  Write  Cache  Request  because  the  default  for  a  write  hit  requires  one  clock  cycle 
after  tne  cache  has  been  accessed  to  update  the  cache.  The  memory  is  still  waiting  for  the 
memory  access  of  the  first  write  memory  request.  The  Next  Request  Time  indicates  that 
the  CPU  is  waiting  for  the  cache  to  finish  with  the  last  write  request 
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Figure  8  Trace  Display  For  Tinie=3 


Figure  9  shows  the  display  for  Time  is  equal  to  4.  The  last  write  request  has 
compieted  and  the  data  provided  by  th  rite  request  was  placed  in  block  64.  As  a  result, 
the  last  two  sub  blocks  are  valid.  The  data  was  also  placed  into  the  Write  Buffer.  At  first, 
it  seems  as  though  the  two  write  memory  requests  should  have  been  combined.  The 
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resulting  request  would  have  had  an  address  of  108  and  a  size  of  12.  Because  words  are 
accessed  in  memory  in  modulo  form,  the  data  for  the  first  sub  block  would  have  been 
accessed  last.  However,  because  the  last  memory  write  request  was  in  progress,  the 
request  could  not  modify  its  starting  address.  Therefore,  two  different  requests  resulted, 
and  the  Read  Buffer's  memory  request  size  has  been  reduced  by  8  bytes.  This  is  an 
example  of  updating  the  Read  Buffer  with  write  data.  This  scoreboarding  policy  is  a 
default  for  SACS,  and  can  be  disabled.  The  result  is  that  the  read  request  does  not  have  to 
c...  .ioS  data  that  was  provided  by  a  write  request. 
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Figure  9  Trace  Display  For  Time=4 
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Figure  10  shows  the  trace  display  for  Time  equal  to  5.  The  last  read  request  has 
turned  out  to  be  a  miss.  The  buffers  were  also  no  help.  At  first  glance,  it  might  seem  as 
though  the  read  buffer  should  have  provided  a  buffer  hit.  This  would  have  been  true  if 


SACS  were  in  a  test  mode.  However,  in  a  non  test  mode,  the  read  buffer  is  not  searched 
because  the  data  is  not  really  available.  It  still  has  to  be  read  in  from  memory  The  first 
write  memory  request  starting  at  address  100  has  completed,  as  predicted  at  Time  equal  to 
5.  The  next  memory  request  was  chosen  to  be  the  write  request  because  it  had  a  high 
priority  of  1 1 ,  versus  the  read  memory  request  with  a  priority  of  1 2.  Unfortunately,  the 
request  began  before  the  cache  could  raise  the  priority  to  1 0.  Once  the  write  request  began, 
the  priority  went  to  0  to  prevent  interruption. 
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Figure  10  Trace  Display  For  Run  #1,  Time=5 
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From  the  TOD  in  Figure  10,  it  is  obvious  that  little  will  happen  until  at  least  the  first 
word  is  sent  to  memory.  The  display  trace  for  Time  equal  to  8,  when  the  first  word  is 
written  to  memory,  is  shown  in  Figure  11.  It  shows  how  SACS  adjusts  its  buffers  to 
represent  individual  words  sent  or  recv.  ad  from  memory.  The  Memory  Waiting  For 
switched  to  Memory  Write  Transfer,  illustrating  the  transition  from  memory  access  to 
memory  transfer.  The  TOD  shows  that  the  write  will  be  complete  at  Time  equal  to  9, 
which  is  a  lot  better  than  the  3  clock  cycles  normally  used  to  access  memory. 
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Figure  1 1  Trace  Display  For  Time=8 
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Figure  1 2  shows  the  completion  of  the  write  memory  request,  and  the  beginning  of 
the  read  memory  request  at  Time  equal  to  9.  The  Block  Buffer  has  also  been  prepared  t<  ’ 
receive  the  read  memory  data.  The  Block  Waiting  For  indicates  that  the  Block  Buffer  is 


busy  receiving  read  data  from  memory.  The  TOA  shows  that  Time  1 2  is  when  the  read 


memory  request  will  be  complete. 
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Figure  12  Trace  Display  For  Time=9 


Figure  13  shows  the  completion  of  the  read  memory  request  at  Time  equal  to  12. 
The  Cache  Waiting  For  indicates  Nothing  because  the  request  was  satisfied  when  the 
required  bytes  arrived  in  the  block  buffer.  The  memory  has  nothing  to  do  because  both  the 
read  and  the  write  buffers  are  empty.  The  simulation  is  not  finished  however,  because  the 
block  buffer  still  has  to  update  the  cache  with  the  new  block  data.  Block  Waiting  For 
shows  that  the  transfer  is  in  progress. 
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Figure  14  shows  the  trace  display  for  Time  equal  to  13.  This  display  shows  how 


the  block  buffer  updated  block  64.  One  word  of  data  was  provided  at  address  104,  making 


the  second  sub  block  valid.  Once  the  block  transfer  was  completed,  SACS  removed  the 


memory  request  from  the  block  buffer. 
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Figure  1 S  shows  the  results  display.  This  display  is  always  shown  at  the  end  of  the 
run.  It  is  interesting  to  note  that  even  with  the  SACS  default  parameters,  which  lean 
toward  providing  the  fastest  response  time  to  all  CPU  requests,  the  average  access  time  for 
the  one  read  miss  was  8  clock  cycles.  Had  this  simulation  been  done  with  Dinero  HI,  the 
user  could  only  have  assumed  that  a  2  byte  read  would  have  taken  the  memory  access  time 
of  3  clock  cycles. 
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Figure  15  Results  Display 


VIII.  CONCLUSION 


For  more  than  a  decade,  caches  have  been  designed  and  built.  Despite  the  time  and 
effort  spent  on  cache  designs,  there  seems  to  be  no  one  design  that  has  emerged  as  the  best 
cache  design.  Even  the  most  basic  choices,  such  as  associativity,  block  size,  and  whether 
to  use  a  unified  cache  or  two  separate  data  and  instruction  caches,  has  not  been  a  clear 
choice,  or  at  least  the  correct  choice  was  not  agreed  upon  by  all  concerned. 

The  diversity  of  cache  designs  has  been  caused  by  budget  constraints,  changing 
memory  technology,  and  changing  CPU  bandwidth  requirements.  Without  proper  timing 
information,  matching  the  correct  cache  to  the  architecture  is  more  of  an  art  than  a  science. 
SACS  offers  a  powerful  tool  in  the  early  planning  phase  of  a  cache  design.  Its  large  set  of 
scoreboarding,  block  management,  and  cache  memory  arguments  allow  the  designer  to 
survey  different  designs  quickly.  SACS  is  well  documented  and  provides  the  designer  with 
a  number  of  debugging  tools,  including  self-testing  and  global  variable  bounds  checking. 
This  makes  modifying  SACS  to  simulate  a  unique  design  feature  extremely  easy  compared 
to  other  programs. 

As  mentioned  throughout  this  paper,  the  most  critical  aspect  of  SACS  is  its  ability 
to  provide  the  designer  with  the  average  access  time.  Since  the  ultimate  purpose  of  the 
cache  is  to  minimize  the  average  access  time,  any  simulator  that  does  not  provide  this 
number  can  only  hope  to  provide  the  designer  with  superficial  and  misleading  data. 
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Future  developments  of  SACS  will  include  more  elaborate  timing  information.  The 
number  of  histograms  will  expand  to  include  what  the  CPU,  memory,  and  block  buffer 
were  waiting  for  during  a  run.  A  new  stall  histogram  will  be  introduced  that  will  allow  the 
user  to  easily  modify  SACS  to  analyze  any  combination  of  conditions.  For  example,  how 
many  times  does  a  read  request  wait  for  access  to  the  cache  memory  while  an  old  write 
miss  request  updates  the  allocated  block.  A  new  global  variable  will  allow  the  user  to 
change  all  the  histogram  displays  to  probability  density  tables. 
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SACS.h 

Still  Another  Cache  Simulator 


Page  1- 


*  *  *  #  # 
1  ** 


Description: 


**  SACS.h  defines  all  enumeration  types.  It  Contains  forward 

**  declarations  of  all  functions  used  in  SACS,  (not  just  SACS.c) .  SACS. 


«  * 

also  includes  a  list  of  all  inline  functions 

(macros) . 

** 

itit 

** 

it  it 

Tadsle  of  Contents 

** 

it* 

** 

** 

Cover  Page  . 

1- 

1 

** 

** 

Enximeration  Definitions  . 

1- 

2 

** 

** 

Type  Definitions  . . . 

1- 

4 

** 

** 

** 

** 

Inline  Function  Definitions 

** 

** 

SubBlock (Address)  . 

. Page 

1- 

5 

** 

*  * 

Set (Address)  . 

1- 

5 

*  * 

*  * 

Bloc)cAddress  (Address)  . 

1- 

5 

*  * 

*  * 

WordAddress (Address)  . 

1- 

5 

*  * 

** 

SubBloc)cAddress  (Address)  . 

1- 

5 

** 

** 

** 

** 

Con?5lete  List  of  Function  Declarations  within  SACS 

** 

** 

SACS.c  . 

1- 

6 

** 

** 

Cache . c  . 

1- 

7 

** 

** 

Memory . c  . 

1- 

8 

** 

** 

TimeEst . c  . 

1- 

9 

** 

Get . c  . 

1- 

10 

** 

Display. c  . 

1- 

11 

** 

** 

Record. c  . 

1- 

12 

** 

** 

Buffer. c  . 

1- 

13 

** 

*  * 

Array . c  . 

1- 

14 

*  * 

** 

TestingSACS.c  . 

1- 

15 

*  * 

*  * 

Checking. c  . 

1- 

16 

** 

#ifndef  _ CACHE. H 

tdefine  CACHE. H 


♦define  ClearScreen  "ClearScr" 


SACS.h 


Page  1-  2 


Enumeration  Definitions 


Description : 


**  Listed  below  are  the  enumerations  used  in  the  SACS  environment.  ** 

**  WaitingForTypes,  and  MemoryWaitingForTypes  are  on  listed  on  the  ** 

**  following  page.  ** 

*  *  *  * 

*****************************************************************************/ 


eniim  YesNoTypes 


No, 

Yes, 

Unknown 


enum  Request Types 


None, 

Read, 

Write, 

NumberOfRequestsAvailable 


entom  BlockReplacementPolicyTypes  { 

LRU, 

FIFO, 

RAND, 

NtimberOfReplacementPoliciesAvailable 


enum  WritePolicyTypes 


WriteThrough, 

WriteBack, 

NumberOfWritePoliciesAvailable 

}; 


enxim  WriteMissPolicyTypes 


WriteAround, 

WriteAllocate, 

NumberOfWriteMissPoliciesAvailable 


enum  CacheWaitingForTypes  { 

Nothing, 

CacheWaitingForReadCacheRequest, 

Ca  cheWait ingForWr i t eCa cheReques t , 
CacheWaitingForReadMemoryRequest , 
CacheWaitingForWriteMemory Request, 
CacheWait ingForFul IReadBu  f  f e r , 
CacheWaitingForFullWriteB’iffer, 
CacheWaitingForCPUCacheAccess, 
NumberOf CacheWait ingForsAvailable 
}; 

eniun  MemoryWaitingForTypes  { 

NothingTwo, 

MemoryWaitingForMemoryReadRequest, 

MemoryWaitingForMemoryRcadAccess, 

MemoryWaitingForMemoryReadTransfer, 

MemoryWaitingForMemoryWriteRequest, 

MemoryWaitingForMemoryWriteAccess, 

MemoryWaitingForMemoryWriteTransfer, 

MemoryWaitingForCacheUpdate, 

NximberOfMemoryWaitingForsAvailable 

}; 

enum  BlockWaitingForTypes  { 

NothingThree, 

MemoryBlockTransfer, 

BlockCacheAccess, 

BlockCacheTransfer, 
NumberOfBlockWait ingForsAvailable 
}; 


**  Page  1-4  ♦* 

**  SACS.h  ** 

★  ♦  ★  ★ 


**  Type  Definitions  ** 
**  Description:  ** 
★  *  ★★ 

**  These  are  all  of  the  type  definitions  used  in  the  SACS  ** 
**  environment,  excluding  enumeration  types  which  are  listed  on  the  last  ** 
**  two  pages.  ** 
★  ★  ★  ♦ 


typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 

typedef 


unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


int  TimeType; 

int  ScoreType; 

int  AddressType; 

int  CacheSizeType; 

int  SizeType; 

int  Buf ferSizeType; 

int  PriorityType; 

int  AssociativityType; 

int  HistogramIndexType; 


typedef  enum  YesNoTypes 
typedef  enum  RequestTypes 
typedef  enum  BlockReplacementPolicyTypes 
typedef  enum  WriteMissPolicyTypes 
typedef  enum  WritePolicyTypes 
typedef  enum  CacheWaitingForTypes 
typedef  enum  MemoryWaitingForTypes 
typedef  enum  BlockWaitingForTypes 


YesNoType; 

RequestType; 

BlockReplacementPolicyType; 

WriteMissPolicyType; 

WritePolicyType; 

CacheWait ingForType ; 
MemoryWaitingForType; 
BlockWait ingForType; 


struct  MemoryRequestStructType 

AddressType  Address; 

SizeType  Size; 

SizeType  RequiredSize; 

SizeType  Block; 

PriorityType  Priority; 

YesNoType  AccessInProgress; 

TimeType  TimeToExecute; 

TimeType  CompletionTimeEstimate; 

}; 

typedef  struct  MemoryRequestStructType  MemoryRequestType; 


struct  Buf ferStruct Type 
{ 

MemoryRequestType  MemoryRequest [ 10 ] ; 

YesNoType  Full; 

YesNoType  Empty; 

Buf ferSizeType  Next; 

BufferSizeType  Max; 

CacheWait ingForType  WaitingForFlag; 

}; 

typedef  struct  Buf ferStructType  BufferType; 


**  Page  1-5  ** 

SACS.h  ** 


Inline  Function  Definitions 


** 
irit 
it  * 

**  Description; 

*  * 

**  These  macros  act  as  inline  functions.  They  are  the  only 

**  macros  which  act  as  inline  functions  within  the  SACS  environment, 
**  except  those  located  in  "TestSACS.c" . 


#  * 

it  1r 
** 
it  it 
it  it 
it  it 
irit 
it  * 


♦define  SubBlock (Address)  ( ( (Address) %BlockSize) /SubBlockSize) 

♦define  Set (Address)  (( (Address) /BlockSize) iNumberOf Sets) 

♦define  BlockAddress (Address)  (( (Address) /BlockSize) *BlockSize) 

♦define  WordAddress (Address)  ( ( (Address) /WordSize) *WordSize) 

♦define  SubBlockAddress (Address)  ( ( (Address) /SubBlockSize) ‘SubBlockSize) 


**  Page  1-  6  ** 


**  SACS.h  ** 

**  ★★ 

**  List  of  SACS.c  Function  Declarations  ** 

**  ★* 

**  Description:  ** 

**  ★* 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "SACS.c".  ** 

**  ** 


extern 

int 

main ( ) ; 

/*  Page 

2-  8 

*/ 

extern 

void 

LoadArguments {) ; 

/*  Page 

2-11 

*/ 

extern 

unsigned  long 

int  ScanArgument ( ) ; 

/*  Page 

2-14 

*/ 

extern 

void 

InitializeProgrammersGlobalVariables () ; 

/*  Page 

2-15 

*/ 

extern 

void 

InitializeBuffers  0 ; 

/*  Page 

2-16 

*/ 

extern 

void 

uefineArrays  0 ; 

/*  Page 

2-17 

*/ 

extern 

void 

FreeArrays () ; 

/*  Page 

2-18 

*/ 

extern 

void 

OpenDataFile  0 ; 

/*  Page 

2-19 

*/ 

extern 

void 

CloseDataFile ( ) ; 

/*  Page 

2-20 

*/ 

extern 

void 

PauseForCommandO ; 

/*  Page 

2-21 

*/ 

extern 

void 

Pause ( ) ; 

/*  Page 

2-23 

*/ 

**  Page  1-  7  ** 

**  SACS.h  •  ** 

★  *  ★★ 


List  of  Cache. c  Function  Declarations 


**  Description: 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  "Cache. c". 


Irir 
Irir 
Itit 
Irit 
★  ★ 

_  _ _ _ _  _  ★★ 

*★  ★★ 


extern 

void 

CacheModel 0 ; 

/* 

Page 

4-  3 

*/ 

extern 

void 

IsRequestAHit ( ) ; 

/* 

Page 

4-  4 

*/ 

extern 

void 

ReadHit ( ) ; 

/* 

Page 

4-  5 

*/ 

extern 

void 

ReadMiss  0 ; 

/* 

Page 

4-  6 

*/ 

extern 

void 

WriteHit () ; 

/* 

Page 

4-  7 

*/ 

extern 

void 

WriteMiss () ; 

/* 

Page 

4-  8 

*/ 

extern 

void 

AccessCache  0 ; 

/* 

Page 

4-10 

*/ 

extern 

void 

SelectBlockVictimO  ; 

/* 

Page 

4-11 

*/ 

extern 

void 

SetDirtyBits () ; 

/* 

Page 

4-13 

*/ 

extern 

void 

WriteDirtySubBlocks () ; 

/* 

Page 

4-14 

*/ 

extern 

void 

AddToReadBuf f er ( ) ; 

/* 

Page 

4-16 

*/ 

extern 

YesNoType 

SearchCache ( ) ; 

/* 

Page 

4-20 

*/ 

extern 

void 

AddToWriteBuf fer  0  ; 

/* 

Page 

4-21 

*/ 

extern  void  MemoryModel () ; 
extern  void  SelectMemoryRequest ( )  ; 

extern  void  StartMemoryReads ( )  ; 

extern  void  ContinueMemoryReads ()  ; 

extern  void  StartMemoryWrites () ; 

extern  void  ContinueMemoryWrites ()  ; 

extern  void  UpdateCache ()  ; 
extern  void  AddAWordToMemoryRequest ()  ; 
extern  void  RemoveAWordFromMemoryRequest {) ; 


/* 

Page 

5-  3 

*/ 

/* 

Page 

5-  4 

*/ 

/* 

Page 

5-  5 

*/ 

/* 

Page 

5-  6 

*/ 

/* 

Page 

5-  8 

*/ 

/* 

Page 

5-  9 

*/ 

/* 

Page 

5-11 

*/ 

/* 

Page 

5-13 

*/ 

/* 

Page 

5-14 

*/ 

**  Page  1-9  ** 
**  SACS.h  ** 
**  ** 


List  of  TimeEst.c  Function  Declarations 


Itir 

**  Description: 

*it 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  TimeEst.c 


** 
it  it 
*  1r 

★  ★  ** 


extern  void  UpdateTimeToExecute () ; 
extern  void  CalculateTimeEstimates () ; 


/*  Page  6-  3  */ 
/*  Page  6-  5  */ 


SACS.h 


Page  1-10 


**  List  of  Get.c  Function  Declarations 

*  it 


** 
it  it 


**  Description:  ** 

**  ** 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "Get.c". 


extern  void  GetNextRequest ( ) ;  /*  Page  7-  3  */ 
extern  void  GetNextFileRequest () ;  /*  Page  7-  5  */ 
extern  void  GetNextKeyBoardRequest ( ) ;  /*  Page  7-  6  */ 


Page  1-11  ** 

*ir 


** 

**  SACS.h 

**  List  of  Display -c  Function  Declarations  ** 

*  #  irie 


**  Description: 

** 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  "Display. c". 


** 

**- 

*■* 


extern 

void 

DisplayTrace  0 ; 

/* 

Page 

8-  3 

*/ 

extern 

void 

DisplayCurrentRequest () ; 

/* 

Page 

8-  4 

*/ 

extern 

void 

DisplayWaitingFors () ; 

/* 

Page 

8-  5 

V 

extern 

void 

DisplayBlock ( ) ; 

/* 

Page 

8-  6 

*/ 

extern 

void 

DisplayBuffers () ; 

/* 

Page 

8-  7 

*/ 

extern 

void 

DisplayBuffer () ; 

/* 

Page 

8-  8 

*/ 

extern 

void 

DisplayRequestsBreakDownO ; 

/* 

Page 

8-  9 

*/ 

extern 

void 

DisplayRequestHistogramO ; 

/* 

Page 

8-11 

*/ 

extern 

void 

DisplayStallHistogramO ; 

/* 

Page 

8-13 

*/ 

extern 

ScoreType 

LastScreenHistogramScore  0 ; 

/* 

Page 

8-14 

*/ 

extern 

void 

DisplayCacheArguments () ; 

/* 

Page 

8-15 

*/ 

extern 

void 

DisplayHelp ( ) ; 

/* 

Page 

8-17 

*/ 

extern 

void 

DisplayTestingHeader  0 ; 

/* 

Page 

8-18 

extern 

void 

PrintYesNo  0 ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintRequest () ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintReplacementPolicy 0 ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintWritePolicy  0  ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintWriteMissPolicy () ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintWaitingFor 0  ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintMemoryWaitingFor () ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintBlockWaitingFor  0 ; 

/* 

Page 

8-19 

*/ 

extern 

void 

PrintTime ( ) ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintTimeCenteredO  ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintScoreCenteredO ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintAddress () ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintCacheSize () ; 

f* 

Page 

8-20 

*/ 

extern 

void 

PrintSize  0 ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintSize2 () ; 

/* 

Page 

8-20 

*/ 

extern 

void 

PrintBufferSize () ; 

/* 

Page 

8-21 

*/ 

extern 

void 

PrintPriority ( ) ; 

/* 

Page 

8-21 

*/ 

extern 

void 

PrintAssociativity 0  ; 

/* 

Page 

8-21 

*/ 

extern 

void 

PrintHistogramlndex ( )  ; 

/* 

Page 

8-21 

*/ 

extern 

void 

PrintBit  0  ; 

/* 

Page 

8-22 

*/ 

extern 

void 

PrintPercent () ; 

/* 

Page 

8-22 

*/ 

extern 

••A  • 

W 

rrint.V.'cAcccs*^  () ; 

/* 

Page 

8-22 

*/ 

**  Page  1-12  ** 
**  SACS.h  ** 
**  ** 

**  List  of  Record. c  Function  Declarations  ** 


«  * 


Description: 


*  * 

*  # 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  "Record. c". 


★  ★ 

♦  ★  ★  ★ 


extern 

void 

RecordRequest () ; 

/* 

Page 

9-  3 

*/ 

extern 

void 

RecordStall  0 ; 

/* 

Page 

9-  5 

*/ 

extern 

void 

RecordForMatlab ( ) ; 

/* 

Pege 

9-  7 

*/ 

extern  void 

extern  MemoryRequestType 
extern  void 
extern  void 

extern  MemoryRequestType 
extern  void 
extern  void 
extern  void 
extern  YesNoType 
extern  YesNoType 
extern  void 
extern  YesNoType 


Push  ( ) ; 

PopO  ; 

ChangeTopMemoryRequest ( ) ; 
Append ( ) ; 

View ( ) ; 

Clear ( ) ; 

Order ( ) ; 

Splice  0 ; 

Search  0 ; 

UpdatingReadBuffer 0 ; 
RemoveZeroSizes  () ; 
NoRequestsLeft () ; 


/*  Page  10-  3  */ 
/*  Page  10-  4  */ 
/*  Page  10-  5  */ 
/*  Page  10-  6  *! 
/*  Page  10-  7  */ 
/*  Page  10-  8  */ 
/*  Page  10-  9  */ 
/*  Page  10-10  */ 
/*  Page  10-12  */ 
/*  Page  10-13  */ 
/*  Page  10-15  */ 
/*  Page  10-16  */ 


** 

**  SACS.h 


Page  1-14  ** 

*  ★ 


♦  * 

irit 
it  it 


List  of  Array. c  Function  Declarations 


★  ★ 
it  ir 
*ir 


Description: 


ir  * 
it  it 
ir  * 
*ir 
•k  it 

★  ★  ★  ★ 


This  is  a  list  of  function  declarations  within  the  file  scope 
**  of  "Array.c". 


extern  int  *DefineArraylD {) ; 
extern  int  **DefineArray2D () ; 
extern  void  FreeArraylD () ; 
extern  void  FreeArray2D ( ) ; 


/*  Page  11-  3  */ 
/*  Page  11-  4  */ 
/*  Page  11-  5  */ 
/*  Page  11-  6  */ 


SACS.h 


Page  1-15  ** 


List  of  TestSACS.c  Function  Declarations 


**  Description: 


**  This  is  a  list  of  functions  declarations  within  the  file  scope  ** 

**  of  "TestSACS.c".  ** 

**  ** 


extern  void  ChangeArguments () ; 

extern  void  TestSACSO; 

extern  void  CreatelnstructionSets () ; 

extern  void  ShufflingInstructionSets {) ; 

extern  YesNoType  CanBeSwitchedO ; 

extern  void  WritelnstructionSet 0  ; 


/*  Page  12-  6  */ 
/*  Page  12-  8  */ 
/*  Page  12-  9  */ 
/*  Page  12-12  */ 
/*  Page  12-14  */ 
/*  Page  12-15  */ 


**  List  of  Checking. c  Function  Declarations 

it  it 

**  Description: 

♦  <* 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  "Checking. c" . 

★  ★ 


it  it 
it* 
** 
*  * 
*  * 
*  * 


extern  void  Checking (); 
extern  void  CheckingConstants () ; 
extern  void  PrintConstError () ; 

extern  void  CheckingForValuesOutOfBounds () ; 
extern  void  PrintTimeBoundaryError () ; 

extern  void  PrintScoreBoundaryError () ; 

extern  void  PrintSizeBoundaryError () ; 

extern  void  PrintEnumBoundaryError ( ) ; 

extern  void  CheckingForInconsistencies () ; 

extern  void  Print TotalTimeError () ; 

extern  void  PrintTotalScoreError () ; 

extern  void  CheckingPredictions () ; 
extern  void  PrintScorePredictionError () ; 
extern  void  PrintTimePredictionError () ; 


/*  Page  13-  3  */ 
/*  Page  13-  4  */ 
/*  Page  13-11  */ 
/*  Page  13-12  */ 
/*  Page  13-15  */ 
/*  Page  13-16  */ 
/*  Page  13-17  */ 
/*  Page  13-18  */ 
/*  Page  13-19  */ 
/*  Page  13-21  */ 
/*  Page  13-22  */ 
/*  Page  13-23  */ 
/*  Page  13-24  •/ 
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#endif 


**  SACS.c 

** 

**  Part  Of  SACS  1.0 

**  (StillAnother  Cache  Simulator) 

**  Program  Modified:  3/17/94 

**  File  Modified:  3/17/94 

*  * 

**  Author:  William  G.  Smith 

**  Address:  Electrical  Engineering  Department 
**  Naval  Postgraduate  School 

**  Monterey,  CA  93940 

** 

**  Copyright  1994,  William  G.  Smith 

*  * 

**  Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
**  its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 

**  provided  that  the  above  copyright  notice  appears  in  all  copies.  No 

**  modified  version  of  this  program  should  be  redistributed  without  the 
**  authors  consent.  William  G.  Smith  makes  no  warranty  or 
**  representation,  promise  of  guarantee,  either  expressed  or  implied, 

**  with  respect  to  this  software's  ability  to  produce  valid  results. 

**  This  program  is  provided  "as  is"  any  financial,  personal  or  property 

**  damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 

**  user. 
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**  SACS.c  ** 

*  *  *  * 

**  Still  Another  Cache  Simulator  ** 

•k  it 


★  ★ 


**  Description:  ** 


**  SACS  simulates  all  functions  one  clock  cycla  at  a  time  using  a  ** 
**  global  variable  named  Time.  Normally  it  is  pre:..3rred  to  preform  timing  ** 
**  simulations  using  event  queues  so  that  time  can  advance  to  the  next  ** 
**  event.  However,  in  most  cache  simulations  so  many  things  happen  in  one  ** 
**  clock  cycle  that  en  event  queue  would  probably  not  iiiprove  the  ** 
**  preformance  of  the  simulator  ** 
★  ★  ♦  ♦ 


**  In  the  main  event  loop  of  SACS,  Time  is  incremented  one  clock 

**  cycle  at  a  time.  Time  is  never  changed  by  any  other  procedure. 

**  The  requests  are  entered  into  the  simulation  from  GetNextRequest . 

**  Simulation  of  all  events  is  performed  by  the  Main  Event  Loop  calling 
**  CacheModel,  MemoryModel,  and  UpdateCache. 


♦*  The  main  procedure  of  SACS  seems  to  call  simulations  in  a  fairly 

**  strange  order.  This  is  because  SACS  is  insuring  that  all  events  that 
**  can  be  started,  during  a  particular  clock  cycle  are  started,  and  that 
**  all  events  that  can  bomplete  during  a  particular  clock  cycle  do.  It 
**  also  gives  an  inherent  priority  to  the  cache  access  events. 

**  Specifically  accesses  from  the  CPU  to  the  cache  are  given  higher 
**  priority  that  accesses  from  the  BlockBuffer.  This  is  why  the  Update 
**  Cache  procedure  is  found  in  three  different  places  in  the  main  loop. 

**  Memory  Model  calls  are  found  before  and  after  the  CacheModel.  This 
**  allows  memory  events  that  are  to  conplete  during  a  clock  cycle  to  do 
**  so.  The  Cache  Model  will  then  have  the  benefit  of  the  newly  arrived 
**  data.  The  MemoryMode]  call  after  the  CacheModel  call  insures  that  any 
**  new  memory  reqpjest  made  by  the  cache  are  started  that  clock  cycle. 


♦  * 
k  it 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 


*  * 
*  ♦ 
k  k 
k  k 


**  SACS' s  main  loop  includes  the  source  code  to  control  testing,  ** 
**  checking,  and  tracing.  The  DesiredTime  variable  is  controlled  entirely  ** 
**  by  the  Main.EventLocp .  DesiredTime  represents  a  user  recjuest  to  advan'~e  ** 
**  the  simulation  to  a  particular  time  without  the  trace  on.  SACS  can  not  ** 
**  run  Time  backwards.  However  if  the  Desired  Time.  The  user  can  make  ** 
**  time  requests  using  argi i-ner.*- s  "G  #",  .  ** 
♦  ♦  *  ♦ 


*  * 

★  ♦ 


*  * 


♦  ♦ 
k  k 
k  k 
k  k 


Throughout  MainEventLoop,  CacheWaitingFor  is  checked  to  see  if  ** 
it's  equal  to  Nothing.  This  indicates  that  the  last  request  has  been  ** 
serviced  and  that  the  cache  is  ready  for  the  next  request.  The  ** 
procedures  that  model  wpecific  events  as  P.eadHit,  ReadMiss,  and  ** 
AccessCache  are  called  *  peatedly  during  their  simulations  they  use  ** 
Cache  Waiting  For  and  Time  to  determine  what  to  df'  next.  If  any  of  ** 
these  procedures  needs  to  wait  for  a  period  either  to  simulate  an  ** 
access  or  because  a  resource  js  not  available,  then  they  will  set  Cache  ** 
Waiting  For  to  the  approprince  value.  The  modeling  procedures  in  ** 
Memory  Model  work  the  same  way  using  Memory  Waiting  For.  ** 


**  Whenever  SACS  finds  an  error  or  a  discrepancy  then  the  boolean  ** 
**  va  Lable  Discrepancy  Founa  is  set  to  Yes.  This  forces  SACS  into  a  ** 
**  trace  mode  so  that  the  user  may  try  to  identify  the  cause  of  the  error.  ** 
♦*  In  test  mode  a  discrepancy  forces  SACS  out  of  test  mode  so  that  the  ** 
**  trace  file  that  caused  the  error  is  not  erased  by  a  new  file.  ** 


**»♦♦**♦♦♦♦**♦♦♦*♦*******♦*«*♦*♦♦•♦♦*«**♦*•*****♦****»***♦*********»••***♦♦**/ 
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Still  Another  Cache  Simulator 
continued 


SACS.c  contains  the  source  code  for  mainO,  which  contains  the 
main  loop.  All  initialization  of  global  variables,  array  definitions, 
and  file  management  are  done  inside  "SACS.c". 

For  information  on  what  SACS  does  see  the  User's  Guide. 

For  information  on  how  to  run  SACS  see  the  User's  Guide. 

For  information  on  how  to  modify  SACS  see  the  Programmer' s  Guide . 

For  information  on  how  SACS  works  see  the  Programmer's  Guide. 
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♦include  <stdlib.h> 
♦include  <stdio.h> 


♦include  "SACS.h 
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**  SACS.c  ** 

**  ** 

**  User  Defined  Global  Variables  ** 

**  Description:  ** 

♦  *  ★★ 

**  These  variables  represent  the  programs  input  parameters.  ** 

**  irir 


CacheSizeType 

CacheSize 

s 

8192 

/*  -cs 

*/ 

SizeType 

BlockSize 

= 

16 

/*  -bs 

*/ 

SizeType 

SubBlockSize 

= 

4 

/*  -sbs 

*/ 

AssociativityType 

Associativity 

= 

4 

/*  -a 

*/ 

SizeType 

WordSize 

— 

4 

/*  -ws 

*/ 

TimeType 

ReadCacheAccessTime 

=r 

1 

/*  -rcat 

*/ 

TimeType 

ReadCacheHitTime 

0 

/*  -rcht 

*/ 

TimeType 

ReadCacheMi s  s  Time 

= 

0 

/*  -rcmt 

*/ 

TimeType 

WriteCacheAccessTime 

= 

1 

/*  -wcat 

*/ 

TimeType 

WriteCacheHitTime 

= 

1 

/*  -wcht 

*/ 

TimeType 

WriteCacheMissTime 

= 

0 

/*  -wcmt 

*/ 

TimeType 

MemoryAccessTime 

z= 

3 

/*  -mat 

*/ 

TimeType 

MemoryTrans  f erTime 

s 

1 

/*  -mtt 

*/ 

TimeType 

BufferCacheAccessTime 

* 

1 

/*  -beat 

*/ 

BufferSizeType 

ReadBufferSize 

3S 

4 

/*  -rbs 

*/ 

BufferSizeType 

WriteBufferSize 

as 

4 

/*  -wbs 

*/ 

BlockReplacementPolicyType  BlockReplacementPolicy 

= 

LRU; 

/*  -brp 

*/ 

WritePolicyType 

WritePolicy 

m 

WriteThrough;  /*  -wp 

*/ 

WriteMissPolicyType 

WriteMissPolicy 

= 

WriteAllocate; /*  -wmp 

*/ 

YesNoType 

ReadForward 

= 

Yes; 

/* 

-rf 

-drf 

*/ 

YesNoType 

CPUWaitsForCacheWrites 

- 

No; 

/  * 

-ewfew  -dewfew 

*/ 

YesNoType 

SearchBlockBuf fer 

s 

Yes; 

/* 

-sbb 

-dsbb 

*/ 

YesNoType 

Updat eReadBu f f er 

= 

Yes; 

/* 

-urb 

-durb 

*/ 

YesNoType 

Remo veReadDup 1 i cat  e s 

* 

Yes; 

/* 

-rrd 

-drrd 

*/ 

YesNoType 

RemoveWriteDuplicates 

— 

Yes; 

/* 

-rwd 

-drwd 

*/ 

PriorityType 

ReadPriority 

1; 

/* 

-rpr 

*/ 

PriorityType 

WritePriority 

= 

2; 

/* 

-wpr 

*/ 

PriorityType 

ReadForWriteAllocatePriority 

= 

3; 

/* 

-rfwapr 

*/ 

PriorityType 

WriteDirtyBlockPriority 

4; 

/* 

-wdbpr 

*/ 

PriorityType 

NoPriority 

“ 

100; 

/* 

-npr 

*/ 

YesNoType 

Trace 

> 

No; 

/* 

-t  -dt 

*/ 

YesNoType 

Check 

- 

Yes; 

/* 

-c  -dc 

*/ 

YesNoType 

Test 

*= 

No; 

/* 

-test 

*/ 

YesNoType 

KeyBoardIO 

No; 

/* 

-kbio  -fio 

*/ 

char 

♦DataFileName 

= 

"SACS 

Dat"; 

/* 

-f 

*/ 

HistogremnlndexType 

ScreenHistogramMaxIndex 

5; 

/* 

-shmi 

♦/ 

HistogramIndexType 

FileHistogramMaxIndex 

- 

10; 

/• 

-fhmi 

*/ 

**  Page  2-4  ** 
**  SACS.C  ** 
•**  ** 

**  Programmer  Defined  Global  Variables.  ** 
#  #1^ 


Time Type  Time; 

Time Type  DesiredTime; 

CacheWaitingForType  CacheWaitingFor; 
MemoryWaitingForType  MemoryWaitingFor; 
BlockWaitingForType  BlockWaitingFor; 
YesNoType  DiscrepancyFound; 


YesNoType 

YesNoType 

YesNoType 


CacheHit ; 

BufferHit; 

CacheBusy; 


RequestType 

RequestType 

AddressType 

SizeType 

SizeType 

TimeType 


Request; 
LastRequest; 
RequestAddress ; 
RequestSize; 
RequestBlockNumber; 
TimeOfNextRequest ; 


SizeType 

SizeType 

SizeType 


NtimberOfBlocks ; 
NumberOf SubBlocks ; 
NumberOfSets; 


AddressType 

TimeType 

SizeType 

YesNoType 

YesNoType 


♦CacheBlockAddress;  /* 
♦LastCacheBlockAccessTime; 
♦CacheNextBlock;  /* 
•♦CacheValidBit;  /* 
**CacheDirtyBit;  /* 


[NumberOfBlocks ] 

*/ 

[NumberOfSets] 

*/ 

(NumberOfBlocks ] 

V 

[NumberOf SubBlocks ] 

*/ 

TimeType 

TimeType 

TimeType 

TimeType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 

ScoreType 


**RequestTimeHistogram;  /»  [NumberOfRequestsAvailable]  */ 

/*  [FileHistogramMaxIndex]  */ 

**StallTimeHistogram;  /*  INumberOfWaitingForsAvailable] */ 

/•  [FileHistogramMaxIndex]  */ 

*TotalRequestTime;  /*  [NumberOfRequestsAvailable]  */ 

♦TotalStallTime;  /*  [NumberOfWaitingForsAvailable] */ 

♦NumberOf Accesses;  /*  [NumberOfRequestsAvailable]  */ 

♦NumberOf CacheHits; 

♦NumberOfBufferHits; 

♦Predict  edNumberOf Accesses ; 

♦PredictedNumberOfHits; 

TotalNumberOf Accesses  =0;  /♦  Not  reset  during  test  */ 


ScoreType 

ScoreType 

ScoreType 


TotalNumberOf WordsReadFromMemory ; 
TotalNumberOf WordsWrittenToMemory; 
TotalNumberOfWordsWrittenToCache; 


BufferType 
Buffer Type 
BufferType 


ReadBuf fer; 
WriteBuffer; 
BlockBuf fer; 


AddressTyre 

TimeType 

TimeType 

TimeType 


MAR; 

TOA; 

TOD; 

BlockTOA; 


FILE 

YesNoType 


♦DataFile; 

EndOfDataFile; 


**  Page  2-  5  ** 

**  SACS.C  ** 

**  Ir* 

**  Programmer  Defined  Global  Variables  ** 

**  continued  ** 

irit  ** 

★  ★ 
*  ♦ 
★  ★ 
*  * 

Enumerator  strings  are  string  copies  of  enumeration  types.  These  ** 

**  are  used  for  display  purposes.  ** 

★  ★  ★★ 


*  * 
*  ■* 

♦  Hr 

♦  ♦ 


Enumerator  Strings 


Description : 


char  *YesNoString[3] = 

"No 

"Yes 

"Unknown" 

}; 

char  *RequestString  [NumberOfRequestsAvailcible]  = 

"None  ", 

"Read  ", 

"Write" 

}; 

char  *ReplacementPolicyString  [NumberOfReplacementPoliciesAvailable]  = 

"LRU  ", 

"FIFO", 

"RAND" 

}; 

char  "WritePolicyString [NumberOfWritePoliciesAvailable]  = 

{ 

"Write  Though", 

"Write  Back  " 

}; 

char  *WriteMissPolicyString [NumberOfWriteMissPoliciesAvailable]  = 

{ 

"Write  Around  ", 

"Write  Allocate" 

}; 


**  Page  2-6  ** 

**  SACS.c 


** 
*  * 
*  <* 

★  ★ 


Progreunmer  Defined  Global  Varieibles 
continued 

Enumerator  Strings 
continued 


ir  * 
*  * 


**  Description: 


** 
*  ir 
it* 
ir* 
** 


*  * 

** 

*  * 

**  ** 


numerator  strings  are  string  copies  of  enumeration  types.  These  ** 
are  used  for  display  purposes.  ** 


char  *CacheWaitingForString [NumberOfCacheWaitingForsAvailable] • 

{ 

"Nothing  " , 

"Read  Cache  Request  ", 

"Write  Cache  Request  ", 

"Read  Memory  Request  ", 

"Write  Memory  Request", 

"Full  Read  Buffer  ", 

"Full  Write  Buffer  ", 

"CPU  Cache  Access  " 

}; 

char  "MemoryWaitingForString [NumberOfMemoryWaitingForsAvailable] = 

"Nothing  ", 

"Memory  Read  Request  ", 

"Memory  Read  Access  ", 

"Memory  Read  Transfer  ", 

"Memory  Write  Request  ", 

"Memory  Write  Access  ", 

"Memory  Write  Transfer", 

"Cache  Update  " 

}; 

char  "i^lcckWaitingForString [NumberOfBlockWaitingForsAvailable]= 

"Nothing  ", 

"Memory  Block  Transfer", 

"Block  Cache  Access  ", 

"Block  Cache  Transfer  " 

}; 
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SACS.C  ** 

** 


List  of  SACS.C  Function  Declarations 


★  ★ 

**  Description: 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  "SACS.C". 

*  ★ 


■kit 
kk 
kk 
k  k 
k  k 
kk 
kk 


int 

main ( ) ; 

/* 

Page 

2-  8 

*/ 

void 

LoadArguments ( ) ; 

/* 
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*/ 

unsigned  long 

int  ScanArgument ( ) ; 

/* 
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*/ 

void 

InitializeProgrammersGlobalVariables () ; 

/* 
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*  / 

void 

InitializeBuffers () ; 

/* 
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*/ 

void 

Def ineArrays {) ; 

/* 
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void 

FreeArrays ( ) ; 

/* 
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*/ 

void 

OpenDataFile  0 ; 

/* 
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void 

CloseDataFile ( ) ; 

/* 
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void 

PauseForCommand ( ) ; 

/* 
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*/ 

void 

Pause  0 ; 

/* 
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**  SACS.c  ** 

**  ** 

**  main  ** 

*  *  *  * 


main(argc,  argv) 
int  argc; 
char  *argv ( ] ; 


LoadArguments (argc, argv) ; 

if  (KeyBoardlO=*-No  ||  Test==Yes)  OpenDataFile  ()  ; 

Time-0; 

while  (Time"0  |  I  Te3t==Yes) 

{ 

if  (Test-Yes)  ChangeArguments  ()  ; 

InitializePrograunmersGlobalVariables () ; 

InitializeBuffers () ; 

DefineArrays () ; 

if  (Tfest==Yes)  TestSACS (PredictedNumberOfAccesses,  PredictedNumberOfHits) 

RecordRequest (NumberOfRequestsAvailable) ;  /*  Reseting  LastTimes  */ 
RecordStall (NvimberOfCacheWaitingForsAvailable) ; 

CheckingConstants (Yes) ; 

GetNextRequest ( ) ; 

CacheHit-Unknown ; 

BufferHit-Unknown; 


/****♦*************************★********************************************** 
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**  SACS.C  ** 

★  *  *★ 

Main  Event  Loop.  ** 

★  ★  ♦  ★ 

★★*****★******■*★★*★★★***★★★★★★★★*★★*♦**★*★★****★**★♦**♦**★*******★******★*★★*/ 

while  ( (Request+CacheWaitingFor+MemoryWaitingFor>Nothing  | I 
Tiine<=TimeOfNextRequest)  && 

DiscrepancyFounci==No  && 

Tiine>0  ) 


if  (BlockWaitingFor==BlockCacheTransfer)  UpdateCache ( )  ; 
MemoryModel  0 ; 

CacheModel 0 ; 

if  (BlockWaitingFor==BlockCacheAccess  &&  BufferCacheAccessTiine==0) 
UpdateCache ( ) ; 

MemoryModel ( )  ; 

RecordRequest (Request)  ; 

if  (CacheWaitingFor==Nothing)  Request=None; 

RecordRequest (Request ) ; 

ReccrdStall (CacheWaitingFor) ; 

if  (Time==DesiredTime)  {  Trace=Yes;  DesiredTime=0;  } 


if  (CacheWaitingFor ! “Nothing  4& 

( (CPUWaitsForCacheWrites  &&  Request-‘“Write)  II  Request==Read) ) 
TimeOfNextRequest++; 


if  (Time>“TimeOfNextReqnaest  &&  CacheWaitingFor==Nothing) 

( 

GetNextRequest ( ) ; 

CacheHit-Unknown;  Buf ferHit=Unknown; 
if  (Request==None) 

( 

if  (BlockWaitingFor==BlockCacheAccess)  UpdateCache ()  ; 
Time++; 

RecordStall (CacheWaitingFor)  ; 

RecordRequest (Request)  ; 

Time — ; 

if  (Check)  CheckingO; 
if  (Trace)  PauseForCoramandO  ; 

Time++; 

} 

else 

( 

if  (BlockWaitingFor“=BlockCacheAccess)  UpdateCache () ; 
Time++; 

RecordStall (CacheWaitingFor) ; 

RecordRequest (Request)  ; 

Time — ; 

if  (Check)  CheckingO; 
if  (Trace)  PauseForCommand ( ) ; 

Time++; 

} 

if  (Time>DesiredTime  &&  DesiredTime!=0)  Time-0; 

) 


*  * 


Page  2-10  ** 
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**  SACS.C 

**  ** 

**  End  Of  Main  Event  Loop.  ** 

■kir  ** 


if  (Test==Yes  &&  DiscrepancyFound==>No) 
{ 


CheckingPredictions () ; 

TotalNuinberOfAccesses+=NumberOf Accesses [Read] 

+NuinberOfAccesses  [Write] ; 


) 

/♦if  (TotalNtanberOfAccesses>=11270)  {Trace=Yes;  Test=No;}*/ 

if  (DiscrepancyFound==Yes) 

[ 

Pause ( ) ; 

Trace-Yes; 

Test-No; 

DesiredTime=0; 

Time-0; 

} 

if  (DiscrepancyFound==No  &&  Test=-No  &&  Time!=0) 

[ 

DisplayRequestsBreakDown 0 ; 

RecordForMatlab  0 ; 

) 

FreeArrays ( ) ; 

rewind (DataFile) ; 

EndOfDataFile=No; 


if  (KeyBoardIO==No)  CloseDataFile () ; 
return (0) ; 


} 


**  LoadArguments 

*  * 

**  Description: 

*  * 

**  LoadArgioments  takes  the  argument  list  argv  and  changes  the 

**  user  defined  global  variables  (See  Page  2-3) . 

*  it 


void  LoadArguments (argc, argv) 

int  argc; 
char  *argv [ ] ; 

( 


int  i, j; 


for  (i=l;  i<argc;  i++) 
{ 


if  ( ! (strcmp<argvti] , "-CS" 
CacheSize 

if  ( ! (strcmp(argv[i] , "-bs" 
BlockSize 

if  ( ! (strcmp (argv[i j , "-sbs" 
SubBlockSize 

if  (i (strcmp (argv [i], "-a" 
Associativity 
if  ( !  (strcnp(argv[i] ,  "-WS" 
WordSize 


))) 

=  ScanArgument (argv [ ++i ] ) ; 
))) 

-  ScanArgument (argv [++il ) ; 
))) 

=  ScanArgument (argv  t++i] )  ; 
))) 

=  ScanArgument (argv  [ ++i ] )  ; 
))) 

=  ScanArgument (argv [++i] ) ; 


if  ( ! (strcnp (argv [i] , "-rcat 
ReadCacheAccessTime 
if  (! (strcmp (argv [i] , "-rcht 
ReadCacheHitTime 
if  (! (strcmp (argv [i] , "-rcmt 
ReadCa  cheMi s  s Time 
if  (! (strcmp (argv [i] , "-wcat 
WriteCacheAccessTime 
if  ( ! (strorp (argv[i] , "-wcht 
WriteCacheHitTime 
if  ( !  (strcnp(argv[i] ,  "-wcmt 
WriteCacheMissTime 

if  (! (strcmp (argv [i] , "-mat" 
MemoryAcce s sTime 
if  ( 1 (strcmp (argv [i] ,  "-mtt" 
MemoryTransferTime 
if  (! (strcmp (argv [i] , "-beat 
BufferCacheAccessTime 

if  ( 1  (strcitp(argv[i] ,  "-rbs" 
ReadBufferSizc 
if  (! (strcmp (argv [i] , "-wbs" 
WriteBufferSize 


))) 

=  ScanArgument (argv [++i] )  ; 
))) 

=  ScanArgument (argv [++i] )  ; 
))) 

=  ScanArgument (argv [ ++i ] ) ; 
))) 

=  ScanArgument (argv [++i] )  ; 
))) 

=  ScanArgument (argv [++i] ) ; 
))) 

“  ScanArgument (argv [ ++i ] ) ; 
))) 

=  ScanArgument (argv [++i] ) ; 
))) 

=  ScanArgument (argv [++i] )  ; 
))) 

“  ScanArgument (argv [ ++i ] )  ; 
))) 

-  ScanArgument (argv [++i] ) ; 
))) 

=  ScanArgument (argv [ ++i ] ) ; 
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*  *  *  * 

**  LoadArguments  ** 
**  Continued  ** 


if  ( !  (strcitip  (argv  [i] ,  "-brp") ) ) 

{ 

BlockReplaceinentPolicy=-l; 

for  (j“0;  j<NuinberOfReplacementPoliciesAvailable;  j++) 
{ 

if  (1 (strcmp (argv [i] , ReplacementPolicyString [ j ] ) ) ) 
BlockReplacementPolicy* 3 ; 

} 

if  (BlockReplacementPolicy<0) 

{ 

printf ("Invalid  Block  Replacement  Policy"); 
exit  (1) ; 

} 


if  (! (strcmp (argv[i] , "-wp") ) ) 

( 

WritePolicy=-l ; 

for  (j=0;  j<NumberOfWritePoliciesAvailable;  j++) 

if  (! (strcn?)(argv[i] ,WritePolicyString[ j] ) ) ) 
WritePolicy«j; 

) 

if  (WritePolicy<0) 

printf ("Invalid  Write  Policy"); 
exit  (1) ; 

} 


if  (! (strcmp (argv[i] , "-wmp") ) ) 

WriteMissPolicy— 1 ; 

for  (j“0;  j<NumberOfWriteMissPoliciesAvailable;  j++) 

if  ( 1 (strcnp  (argv [i] , WriteMissPolicyString [ j ] ) ) ) 
WriteMissPolicy- j ; 

} 

if  (WriteMi3SPolicy<0) 

I 

printf ("Invalid  Write  Miss  Policy"); 
exit  (1) ; 

} 


if  ( !  (strcinp  (argvfi] ,  "-rf"  )))  ReadForward  =  Yes; 

if  ( ! (strcnp (argv [i] , "-drf "  )))  ReadForward  =  No; 

if  ( ! (strcmp (argv [i] , "-cwfcw"  )))  CPUWaitsForCacheWrites  =  Yes; 

if  ( !  (strcinp(argv[i] ,  "-dcwfcw") ) )  CPUWaitsForCacheWrites  =  No; 

if  (! (strcmp (argv [i] , "-sbb"  )))  SearchBlockBuffer  =  Yes; 

if  (! (strcmp (argv [i] , "-dsbb"  )))  SearchBlockBuffer  =  No; 

if  (! (strcmp (argv [i] , "-urb"  )))  UpdateReadBuffer  =  Yes; 

if  ( ! (strcnp(argv[i] , "-durb"  )))  UpdateReadBuffer  =  No; 

if  (! (strcmp (argv [i] , "-rrd"  )))  RemoveReadDuplicates  =  Yes; 

if  (! (strcmp (argv[i] , "-drrd"  )))  RemoveReadDuplicates  =  No; 

if  (! (strcmp (argv [i] , "-rwd"  )))  RemoveWriteDuplicates  =  Yes; 

if  (! (strcmp (argvfi] , "-drwd"  )))  RemoveWriteDuplicates  =  No; 


if  ( 1 (strcnp (argv [i] , "-rpr"  ))) 

ReadPriority  =  ScanArgument (argv [++i] ) ; 

if  ( 1 (strcmp (argv [i] , "-wpr"  ))) 

WritePriority  =  ScanArgument (argv [++i] ) ; 

if  ( ! (strcnp (argv [i] , "-rfwapr") ) ) 

ReadForWriteAllocatePriority  =  ScanArgument (argv [++i] ) ; 

if  ('.( strcmp  (argv  [i],"-wdbpr"  ))) 

WriteDirtyBlockPriority  =  ScanArgument (argv [++i] ) ; 

if  (! (strcmp (argv [i] , "-npr"  ))) 

WriteDirtyBlockPriority  =  ScanArgument (argv [++i] ) ; 


if  (! (strcmp (argv [i] , "-t"  )))  Trace  =  Yes; 

if  (! (strcmp (argv [i] , "-dt"  )))  Trace  =  No; 

if  (! (strcmp (argv [i] , "-C"  )))  Check  =  Yes; 

if  (! (strcmp (argvfi] , "-dc"  )))  Check  =  No; 

if  (! (strcmp (argv [i] , "-test"  )))  Test  =  Yes; 

if  (! (strcmp (argv [i] , "-kbio"  )))  KeyBoardIO  =  Yes; 

if  (! (strcmp (argv [i] , "-fio"  )))  KeyBoardIO  =  No; 

if  ( 1 (strcmp (argv [i] , "-f"  )))  DataFileName  =  argvt++i]; 


if  (! (strcmp (argv [i] ,  "-shmi"  ))) 

ScreenHistogramMaxIndex  =  ScanArgument (argv [++i] ) ; 

if  (! (strcmp (argv [i] , "-fhmi"  ))) 

FileHistogramMaxIndex  =  ScanArgument (argv [++i]); 


} 


it  * 


ScanArgment 


**  Description: 

*  it 

**  ScanArgument  scans  the  input  string  for  an  unsigned  long  int 

**  if  one  is  not  found  an  error  is  raised. 

it  it 

■kit*irit*itititiritiriritiririritiritiritiHritiritiririritiriririririritirirititititiririritiritiriririritieiritititiritiririririririt 


unsigned  long  int  ScanArgument (Argument) 
char  * Argument; 

{ 

unsigned  long  int  Temp; 

if  (sscanf  (Argument,  "%U",  iTeirp)  !=1) 

{ 

printf ("Error  unsigned  integer  expected  [%s3 Argument) ; 
}; 


return (Temp) ; 
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**  SACS.c  ** 

**  ** 

**  InitializeProgrammersGlobalVariables  ** 

**  .  ** 

*  ■* 

**  *  * 

**  InitializePrograiranersGlobalVariables  takes  the  user  defined  global  ** 

**  variables  and  calculates  programmer  defined  global  variables,  which  are  ** 
**  constant,  once  the  input  parameters  are  determined,  and  reinitializes  ** 
**  the  global  variables  what  will  change.  ** 

*  *  ♦  ★ 


**  Description: 


void  InitializeProgrammersGlobalVariables () 


Time 


=  1; 


CacheWaitingFor 

MemoryWaitingFor 

BlockWaitingFor 

DiscrepancyFound 


=  Nothing; 
=  Nothing; 
=  Nothing; 
=  No; 


CacheHit 
Buf ferHit 
CacheBusy 


=  Unknown; 
=  Unknown; 
-  No; 


Request  *  None; 

LastRequest  =  None; 

RequestAddress  =0; 

RequestBlockNumber  =  0; 

Request Size  =  0; 

RequestBlockNumber  =  0; 

TimeOfNextRequest  =  0; 


NumberOf Blocks 

NumberOfSubBlocks 

NumberOfSets 


=  CacheSize/BlockSize; 

=  BlockSize/SubBlockSize; 

=  NumberOfBlocks/Associativity; 


TotalNumberOfWordsReadFromMeraory  =  0 
TotalNumberOfWordsWrittenToMemory  =  0 
TotalNiimberOfWordsWrittenToCache  =  0 


/* 

ReadsLeftForBlock  =  0; 

ReadsLeftForRequest  =  0; 

WritesLeftForBlock  =  0; 

WritesLeftForRec[uest  *  0; 

*/ 

MAR  =  0; 

TOA  =  0; 

TOD  -  0; 

BlockTOA  =  0; 

EndOfDataFile  *•  No; 


} 
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**  SACS.c  ** 

**  ** 

**  InitializeBuffers  ** 

*  *  *  * 

**  Description:  ** 


**  InitializeBuffers  places  the  buffers  in  an  en^ty  state,  with  ** 
**  their  Max  values  set  to  the  appropriate  size.  ** 
*  *  *  * 


void  InitializeBuf fers 0 
{ 

ReadBuf fer .Full  =  No; 

ReadBuf fer .Enpty  =  Yes; 

ReadBuf fer .Next  =  0; 

WriteBuffer  =  ReadBuffer; 

BlockBuffer  =  ReadBuffer; 

ReadBuf fer .Max  =  ReadBufferSize-1; 

WriteBuffer .Max  =  WriteBuf ferSize-1; 

BlockBuf fer .Max  =  0; 

ReadBuffer .WaitingForFlag  =  CacheWaitingForFullReadBuffer; 
WriteBuffer .WaitingForFlag  =  CacheWaitingForFullWriteBuf fer; 
BlockBuf fer. WaitingForFlag  =  Nothing/ 


} 
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**  SACS.c  ** 

**  ** 

**  DefineArrays  ** 

itir  ** 

**  Description:  ** 

★  ★  *  ♦ 

**  DefineArrays  assigns  memory  to  the  array  pointers.  ** 

♦  ★  ★  ★ 


void  DefineArrays () 
{ 


CacheBlockAddress 

T-astCacheBlcckAcoessTime 

CacheNextBlock 

CacheValidBit 

CacheDirtyBit 

RequestTimeHistogram 

StallTimeHistogrcim 

TotalRequestTime 

TotalStallTime 

NumberOf Accesses 

NumberOfCacheHits 

NnmberOfBufferHits 

Predict  edN^ImberOf  Accesses 

Predict  edN\amberOf  Hits 


=  (AddressType*) 

Def ineArraylD (NumberOf Blocks, 

sizeof (AddressType) ) ; 

=  ii'imeType*) 

Def ineArraylD (NumberOfBlocks, 

sizeof (TimeType) ) ; 

=  (SizeType*) 

Def ineArraylD (NumberOf Sets, 

sizeof (SizeType) ) ; 

=  (YesNoType**) 

Def ineArray2D (NumberOfBlocks, 

NumberOf SubBlocks, 
sizeof (YesNoType) ) ; 

=  (YesNoType**) 

Def ineArray2D (NumberOfBlocks, 

NumberOf SubBlocks, 
sizeof (YesNoType) ) ; 

“  (TimeType**) 

DefineArray2D (NumberOfRequestsAvailable, 
FileHistogramMax Index, 
sizeof (TimeType) ) ; 

=  (TimeType**) 

DefineArray2D (NumberOf CacheWaitingForsAvailable, 
FileHistogramMaxIndex, 
sizeof (TimeType) ) ; 

=  (TimeType*) 

Def  ineArraylD  (NiimberOfRequestsAvailable, 
sizeof (TimeType) ) ; 

“  (TimeType*) 

Def ineArraylD (NumberOf CacheWaitingForsAvailable, 
sizeof (TimeType) ) ; 

=  (ScoreType*  ) 

Def ineArraylD (NumoerOf Request sAvailable, 
sizeof (ScoreType) ) ; 

=•  (ScoreType*  ) 

Def ineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 

=  (ScoreType*  ) 

De  f ineArraylD (NumberO  f Reque  s t  sAvai lable , 
sizeof (ScoreType) ) ; 

=  (ScoreType*  ) 

Def  ineArraylD  (NumberO  fRequestsAvailcible, 
sizeof (ScoreType) ) ; 

»  (ScoreType*  ) 

Def  ineArraylD  (N\amberOfRequestsAvailable, 
sizeof (ScoreType) ) ; 


♦  * 
it  it 
it  « 

*  it 

*  * 

**  Description: 
*  * 


SACS . C 
FreeArrays 


Page 


★  ★ 
★  ★ 


FreeArrays  deallocates  the  memory  assigned  to  the  array  points 
by  DefineArrays . 


*  ■* 

**■*■**■*  IT  4 


2-18  ** 

*  it 
it  it 

*  it 
it  * 

*  ★ 
★ 

★  ★ 

*  it 

★  ★ 

•/ 


void  FreeArrays () 
{ 

char  c; 


FreeArraylD (CacheBlockAddress, 
FreeArraylD (LastCacheBlockAccessTime, 
FreeArraylD (CacheNextBlock, 
FreeArray2D (CacheValidBit, 

FreeArray2D (CacheDirtyBit, 

FreeArray2D (RequestTimeHistogram, 

FreeArray2D (StallTimeHistogram, 


FreeArraylD (TotalRequestTime, 
FreeArraylD (TotalStallTime, 

FreeArraylD (NumberOfAccesses, 
FreeArraylD (NumberOfCacheHits, 
FreeArraylD (NumberOfBuf ferHits, 
FreeArraylD (PredictedNumberOf Accesses 

FreeArraylD (PredictedNumberOf Hits, 

} 


NtimberOfBlocks) ; 

NumberOf Blocks) ; 

NtunberOfSets)  ; 

NumberOf Blocks,  NumberOfSubBlocks) ; 
NvmiberOf Blocks,  NumberOfSubBlocks) ; 

NumberOfRequestsAvailable, 
FileHistogramMaxindex) ; 

NumberOf CacheWaitingForsAvailable, 
FileHistogramMaxindex) ; 

NumberOfRequestsAvailable)  ; 
NuraberOfCacheWaitingForsAvailable) ; 

NtimberOfRequestsAvailable) ; 
NuroberOfRecjuestsAvailable) ; 
NumberOfRequestsAvailable) ; 
NumberOfRequestsAvailable) ; 

NumberOfRequestsAvailable) ; 
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*  it 

** 

SACS . c 

*  it 

it* 

** 

OpenDataFile 

it* 

** 

it  it 

Description: 

** 

it  it 

*  * 

*  ■* 

OpenDataFile  opens 

the  file  specified  by  DataFileName  for 

*  * 

*  it 

reading.  This  becomes 

the  data  file  that  GetNextFileRequest  reads 

*  * 

it  it 

from. 

** 

it  it 

*  * 

void  OpenDataiFile  0 


if  (Test==No) 

{ 

if  ( (DataFile=fopen(DataFileName, "r") )==NULL) 

{ 

print f ("Cannot  open  %s  file", DataFileName) ; 
exit (0) ; 

} 

} 

else 

if  ( (DataFile=f open (DataFileName, "w+" ) ) “=NULL) 

{ 

printf ("Cannot  open  %s  file" , DataFileName) ; 
exit (0) ; 

) 
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**  SACS.c  *» 
*★  ** 

**  CloseDataFile  ** 
♦  ♦ 


*  * 
♦  * 
«  * 


Description: 

CloseDataFile  closes  the  data  file  that  OpenDataFile  opened. 


★  ★ 
*  ★ 
#  * 
*  * 
*  * 


void  CloseDataFile () 
{ 

fclose (DataFile) ; 
} 


SACS . c 
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*  * 


Itit 

it* 

**  Description: 


PauseForCommand 


**  PauseForCoiranand  controles  the  displays.  It  takes  input  for  the 

**  keyboard  to  determan  which  display  to  provide.  It  also  adjusts  the 
**  global  variable  Desired  Time  based  on  and  "G  #"  commands. 


*ir 

*  ir 
** 
ir  * 

*  « 
*  # 
*  # 
** 
*  ir 


void  PauseForCommand ( ) 


static  char  LastDisplayMode='  ' ; 

char  Inputstring [255] , 

♦TirqpStringPt, 

CommandChar, 

DisplayMode-'  '  ; 

int  Index; 

TimeType  Tn^iTime; 

if  (Trace— Yes)  LastDisplayMode-' t' ;  else  LastDisplayMode-' r' ; 
while  (DisplayMode ! =LastDisplayMode) 

{ 

if  (DisplayMode!-'  ')  LastDisplayMode-DisplayMode; 
DisplayMode-LastDisplayMode ; 

if  (LastDisplayMode— '  t' )  DisplayTrace  () ; 
if  (LastDisplayMode—'  r' )  DisplayRequestsBreakDown  () ; 
if  (LastDisplayMode— '  s' )  DisplayStallHistogramO  ; 
if  (LastDisplayMode— '  c' )  DisplayCacheArgtiments  () ; 
if  (LastDisplayMode— 'h' )  DisplayHelpO  ; 

printf  ("\nNext  Command  Please  [  T,  R,  S,  C,  G  #,  #,  -#,  Help)  »>"); 

Index— 1; 
do 

( 

Index++; 

scanf ("%c", &InputString[ Index] ) ; 

} 

while (InputString[ Index] !='  \n' ) ; 

while  ( Inputstring [0]—'  ') 

for  (Index-0;  Inputstring [ Index ]!-' \n' ;  Index++) 

Inputstring [ Index ) -Inputstring [ Index+1 ] ; 

CommandChar-InputString[0] ; 

if  (CommandChar>-' A'  &&  CommandChar<-' Z' )  CommandChar+=('a'-'A' ) ; 


PauseForComraand 

continued 


if  (sscanf  (Inputstring,  "%U",  &TmpTirae)==l  CoiranandChar  1=' \n' ) 

DesiredTime=Time+TmpTime ; 

Trace=No; 

} 

i  f  ( CojnniandChar== '  - ' ) 

( 

TinpStringPt=InputString; 

TinpStringPt++; 

if  (sscanf  (TnpStringPt,  "%U", &TnpTim6)==l)  DesiredTime=Time-TiTipTime 
Trace=No; 

} 

if  (CoinmandChar==' g' ) 

( 

TinpStringPt=InputString; 

TmpStringPt++; 

if  (sscanf  (Trr^sStringPt,  "%U",  iTnipTime)==l)  DesiredTinie=TnpTime; 
Trace=No; 

} 


it 

if 

if 

if 

if 

if 


(CominandChar=='  t' ) 
(CoininandChar=='  r'  ) 
(Comn:iandChar=='  s'  ) 
(CommandChar=='  c'  ) 
{CoininandChar=='  h' ) 
(CoinmandChar=='  q'  ) 


DisplayMode='  t' ; 
DisplayMode='  r'  ; 
DisplayMode='  s' ; 
DisplayMode='  c'  ; 
DisplayMode='h' ; 
exit  (0) ; 


Pause 


**  Description: 

ir  * 

**  Waiting  for  a  character  to  be  entered 

void  Pause  0 
{ 

char  InputCharacter; 

printf ("\nHit  the  return  key  to  Continue:") 
do 

scanf ("%c", 4 InputCharacter)  ; 

} 

while  ( InputCharacter ! =' \n' ) ; 


/** 
★  ★ 

ir* 

It  * 
it  * 

★  ♦ 

*  •* 

It  * 

★  ★ 

*  it 
it  it 
it  it 
it  it 
it  it 
it  it 
it  it 


it  it 
*  it 


it  ir 
it  it 
ir  it 
it  it 


rtk"*'*-#-*-^^-*-*'**'*’**-*-*-*''*'*- 
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Global. h 

Part  0^  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 

Address:  Electrical  Engineering  Department 
Naval  Postgraduate  Scl^ool 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  above  copyright  notice  appears  in  all  copies .  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  William  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  implied, 
with  respect  to  this  software's  ability  to  produce  valid  results. 

This  progreira  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user . 


*  *  * 
it  it 
it  * 
it  it 

*  it 
it  * 

*  * 

*  it 

★  * 
★  ★ 

*  it 
it  ir 
it  it 

★ 

★  * 
*  * 
★  ★ 
it  it 
it  it 
★  ★ 
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it  ir 

*  it 
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**  Global. h  ** 

**  ** 

**  Global  Variables  Used  by  SACS  Packages  ** 

*  *  *  * 

**  Description:  ** 

*  ♦  ★  ★ 


**  Global. h  is  the  only  include  file  needed  by  all  of  the  SACS  source  ** 
**  files.  It  contains  all  the  global  variables,  both  user  and  programmer  ** 
**  defined  variables.  The  user  defined  variables  represent  all  the  input  ** 
**  parameters.  The  programmer  defined  variables  represent  all  global  ** 
**  variables  that  are  shared  between  all  the  SACS  source  code  files,  that  ** 


**  the  user  does  not  have  access  to.  ** 

**  ** 

**  SACS.c  defines  all  of  the  initial  values  of  the  global  variables  ** 

**  therefore,  does  not  include  Global. h  ** 

**  ** 

**  Table  of  Contents  ** 

**  ** 


**  Cover  Page  .  Page  3-  1 

**  User  Defined  Global  Variables  .  Page  3-  2 

**  Programmer  Defined  Global  Variables  .  Page  3-  3 

*  * 


*  -k 
k  k 
k  k 
k  k 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk^ 


#ifndef  _ ^GLOBAL. H 

♦define  _ ^GLOBAL. H 

♦include  <stdlib.h> 
♦include  <stdio.h> 

♦include  "SACS.h" 


★  * 

Page 

3-2  ** 

*  # 

Global. h 

★  * 

*  * 

User  Defined  Global  Variables 

★  ♦ 

**  Description: 

★  ★ 

★  ★ 

★  ♦ 

*  -k 

These  variables  represent  the  programs  input  parameters . 

*  * 

********.********************************************************»***********/ 

extern 

CacheSizeType 

CacheSize; 

extern 

SizeType 

BlockSize; 

extern 

SizeType 

SubBlockSize; 

extern 

AssociativityType 

Associativity; 

extern 

SizeType 

WordSize; 

extern 

TimeType 

ReadCacheAccessTime; 

extern 

Time Type 

ReadCacheHitTime ; 

extern 

TimeType 

ReadCacheMissTime; 

extern 

TimeType 

WriteCacheAccessTime; 

extern 

TimeType 

WriteCacheHitTime; 

extern 

TimeType 

WriteCacheMissTime; 

extern 

TimeType 

MemoryAccessTime; 

extern 

TimeType 

MemoryTransferTime; 

extern 

TimeType 

Buf ferCacheAccessTime; 

extern 

bufferSizeType 

ReadBufferSize; 

extern 

Buf ferSizeType 

WriteBufferSize; 

extern  BlockReplacementPolicyType 

BlockReplacementPolicy; 

extern 

WritePolicyType 

WritePolicy; 

extern 

WriteMissPolicyType 

WriteMissPolicy; 

extern 

YesNoType 

ReadForward; 

extern 

YesNoType 

CPUWaitsForCacheWrites ; 

extern 

YesNoType 

SearchBlockBuf fer; 

extern 

YesNoType 

Updat eReadBu f f er ; 

extern 

YesNoType 

Remo veReadDup 1 i cat  e s ; 

extern 

YesNoType 

RemoveWriteDuplicates ; 

extern 

PriorityType 

ReadPriority; 

extern 

PriorityType 

writePriority; 

extern 

PriorityType 

ReadForWriteAllocatePriority; 

extern 

PriorityType 

WriteDirtyBlockPriority; 

extern 

PriorityType 

NoPriority; 

extern 

YesNoType 

Trace; 

extern 

YesNoType 

Check; 

extern 

YesNoType 

Test; 

extern 

YesNoType 

KeyBoarcIIO; 

extern 

char 

♦DataFileName; 

extern 

HistogramindexType 

ScreenHistogramMaxIndex; 

extern 

HistogramIndexType 

FileHistogramMaxIndex; 

.  *  *  « 
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**  Global. h  ** 

**  ** 

**  Programmer  Defined  Global  Variables  ** 

*  *  *  ♦ 


extern 

TimeType 

Time; 

extern 

TimeType 

DesiredTime; 

extern 

CacheWaitingForType  CacheWaitingFor; 

extern 

MemoryWaitingForType  MemoryWaitingFor; 

extern 

BlockWaitingForType  BlockWaitingFor; 

extern 

YesNoType 

DiscrepancyFound; 

extern 

YesNoType 

CacheHit; 

extern 

YesNoType 

Buf ferHit; 

extern 

YesNoType 

CacheBusy; 

extern 

RequestType 

Request ; 

extern 

RequestType 

LastRequest; 

extern 

AddressType 

Request Address ; 

extern 

SizeType 

RequestSize; 

extern 

SizeType 

RequestBlockNumber; 

extern 

TimeType 

TimeOfNextRequest  ; 

extern 

SizeType 

NumberOf Blocks ; 

extern 

SizeType 

NumberOf SubBlocks  ; 

extern 

SizeType 

NumberOf Sets; 

extern 

AddressType 

*CacheBlockAddress; 

/♦ 

(NumberOfBlocks ) 

♦/ 

extern 

TimeType 

♦LastCacheBlockAccessTime; 

extern 

SizeType 

‘CacheNextBlock; 

/♦ 

[NumberOf Sets ] 

♦/ 

extern 

YesNoType 

*  *CacheValidBit ; 

/♦ 

[NumberOfBlocks ] 

♦/ 

extern 

YesNoType 

*  *CacheDirtyBit ; 

/♦ 

[NumberOf SubBlocks] 

♦/ 

extern 

TimeType 

**RequestTimeHistogram; 

/* 

[NumberOfRequestsAvailable ] 

♦/ 

/* 

[FileHistgramMaxIndex ] 

♦/ 

extern 

TimeType 

**StallTimeHistogram; 

/♦ 

[NumberOf CacheWaitingForsAv] 

♦/ 

/♦ 

[FileHistgramMaxIndex] 

♦/ 

extern 

TimeType 

*TotalRequestTime; 

/♦ 

(NumberOfRequestsAvailable ] 

♦/ 

extern 

TimeType 

*TotalStallTime; 

/♦ 

[NumberOf StallsAvailable ] 

♦/ 

extern 

ScoreType 

♦NumberOf Accesses  ; 

/♦ 

(N\imberOf  RequestsAvailable  ] 

♦/ 

extern 

ScoreType 

♦NumberOf CacheHits  ; 

extern 

ScoreType 

♦NumberOfBuf f erHits ; 

extern 

ScoreType 

♦Predict edNumberOf Accesses; 

extern 

ScoreType 

♦PredictedNumberOfHits; 

extern 

ScoreType 

TotalNumberOf Accesses; 

extern 

ScoreType 

TotalNumberOfWordsReadFromMemory; 

extern 

ScoreType 

TotalNumberOfWordsWrittenToMemory; 

extern 

ScoreType 

TotalNumberOfWordsWrittenToCache; 

extern 

BufferType 

ReadBuf fer; 

extern 

Buf ferType 

WriteBuf  fer; 

extern 

BufferType 

BlockBuf fer ; 

extern 

AddressType 

MAR; 

extern 

TimeType 

TOA; 

extern 

TimeType 

TOD; 

extern 

TimeType 

BlockTOA; 

extern 

FILE 

♦DataFile; 

ovt-  or-n 

PnHrifnaf  aFi  To; 
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**  Global. h  ** 

**  ** 

#  * 
*  * 
*  * 

★  *  *★ 


** 
*  it 


Programer  Defined  Global  Variables 
continued 
Enumerator  Strings 


extern  char 


♦YesNoString [ ] , 
•Requeststring [ ] , 
•ReplacementPolicyString [ ] , 
•WritePolicyString [ ] , 
•WriteMissPolicyString  t ] , 


/*  [2]  */ 

/*  [NumberOfRequestsAvailable]  */ 

/*  [ReplacementPolicyString]  */ 

/*  [NumberOfWritePoliciesAvailable]  */ 

/*  [NumberOfWriteMiL .  PoliciesAvailable]  */ 


•CacheWaitingForString [ ] , 
•MemoryWaitingForString ( ] , 
•BlockWaitingForString [ ] ; 


/*  [NumberOfCacheWaitingForsAvailable]  */ 
/*  [NunberOfMemoryWaitingForsAvailable]  */ 
/*  [NumberOfBlockWaitingForsAvailable]  */ 


#endif 
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Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 

Address:  Electrical  Engineering  Department 
Naval  Postgraduate  School 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  cdjove  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  William  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  implied, 
with  respect  to  this  software' s  ability  to  produce  valid  results . 

This  program  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
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Description: 

CacheModel  makes  all  the  necessary  calls  to  simulate  cache  memory. 
CacheModel  decides  which  calls  to  make,  based  on  the  value  of  CacheHit, 
and  Request.  This  function  is  called  every  time  Time  is  incremented. 

If  there  are  no  read  or  write  requests  waiting  to  be  completed  the 
function  does  nothing.  The  value  of  CacheHit  will  remain  Unknown  until 
the  appropriate  cache  access  time  has  expired.  Then  CacheModel  will 
call  IsRequestAHit  to  determine  if  the  request  is  a  hit  or  a  miss. 

Table  of  Contents 

Cover  Page  .  Page  4-  1 

List  of  Cache. c  Function  Declarations  .  Page  4-  2 

CacheModel  0  .  Page  4-  3 

IsRequestAHit  ()  .  Page  4-  4 

ReadHitO  .  Page  4-  5 

ReadMissO  .  Page  4-  6 

WriteHit  0  .  Page  4-  1 

WriteMissO  .  Page  4-  8 

AccessCache  0  .  Page  4-10 

SelectBlockVictimO  .  Page  4-11 

SetDirtyBits  ()  .  Page  4-13 

WriteDirtySubBlocks  0  .  Page  4-14 

AddToReadBuffer  0  .  Page  4-16 

SearchCache  ( )  .  Page  4-20 

AddToWriteBuffer  0  .  Page  4-21 


♦include  "Global. h 
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**  Cache. c  ** 

**  ** 

**  List  of  Cache. c  Function  Declarations  ** 

**  ** 

**  Description:  ** 

**  ** 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "Cache. c".  ** 


void 

CacheModel ( ) ; 

/* 

Page 

4-  3 

*/ 

void 

IsRequestAHit () ; 

/* 

Page 

4-  4 

*/ 

void 

ReadHit ( ) ; 

/* 

Page 

4-  5 

*/ 

void 

ReadMiss  ( ) ; 

/* 

Page 

4-  6 

*/ 

void 

WriteHit  <) ; 

/* 

Page 

4-  7 

*/ 

void 

WriteMiss () ; 

/* 

Page 

4-  8 

*/ 

void 

AccessCache () ; 

/* 

Page 

4-10 

*/ 

void 

SelectBlockVictimO  ; 

/* 

Page 

4-11 

*/ 

void 

SetDirtyBits () ; 

/* 

Page 

4-13 

*/ 

void 

WriteDirtySubBlocks () ; 

/* 

Page 

4-14 

*/ 

void 

AddToReadBuf fer  0 ; 

/* 

Page 

4-16 

*/ 

YesNoType 

SearchCache  0 ; 

/* 

Page 

4-20 

*/ 

void 

AddToWriteBuf f er ( ) ; 

/* 

Page 

4-21 

*/ 

/** 

* 

* 

■*  ♦ 

*  * 
itir 
«■  * 
*  * 
★  ★ 

*  * 
■*  ■* 

*  it 
** 

*  * 
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Cache . c 
CacheModel 


Description: 


CacheModel  makes  all  the  necessary  calls  to  simulate  cache  memory. 
CacheModel  decides  which  calls  to  make,  based  on  the  value  of  CacheHit, 
and  Request.  This  function  is  called  every  time  Time  is  incremented. 

If  there  are  no  read  or  write  requests  waiting  to  be  completed  the 
function  does  nothing.  The  value  of  CacheHit  will  remain  Unknown  until 
the  appropriate  cache  access  time  has  expired.  Then  CacheModel  will 
call  IsRequestAHit  to  determine  if  the  request  is  a  hit  or  a  miss. 


Hit  it 
ir  ir 
it  it 

itir 

it  it 
it  it 
itir 
it  it 
it  it 
it  it 
it  it 
it  it 
it  it 
it  it 
itir 
★  ★ 

**/ 


void  CacheModel 0 


if  ( CacheHit “'Unknown  &&  Request! “None ) 

{ 

if  (Request=“Read  ) 

AccessCache (ReadCacheAccessTime,  CacheWaitingForReadCacheRequest) ; 
if  (Request=“Write) 

AccessCache (WriteCacheAccessTime, CacheWaitingForWriteCacheRequest)  ; 
if  (CacheWaitingFor““Nothing)  IsRequestAHit () ; 

} 

if  (CacheHit==Yes  &&  Request==Read  )  ReadHitO; 

if  (CacheHit-“No  &&  Request“=Read  )  ReadMissO; 

if  (CacheHit=“Yes  Request==Write)  WriteHitO; 

if  (CacheHit“-No  &s  Recjuest-'Write)  WriteMissO; 


} 


it  * 

★  * 

**  Description: 


Cache . c 
IsRequestAHit 
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**  IsRequestAHit  determines  if  the  request  is  a  hit  or  a  miss,  and 

**  sets  CacheHit  to  the  appropriate  value.  IsRequestAHit  will  find  the 
**  SetNiiinber  that  the  data  is  supposed  to  be  in.  Then  all 
**  CacheBlocJcAddresses  in  that  set  will  be  checked  to  see  if  they  equal 
**  the  BlockAddress  for  that,  request.  If  the  correct  block  is  found, 

**  then  all  sub  blocks  that  are  required  to  satisfy  the  request  will  be 
**  inspected  for  validity.  If  all  required  stib  blocks  are  valid  then 
**  CacheHit  will  equal  Yes  on  return  from  IsRequestAHit. 


void  IsRecjuestAHit  () 

{ 

SizeType  SetNumber  =  Set (Request Address ) ; 

SizeType  FirstBlock  =  SetNumber*Associativity; 

SizeType  LastBlock  =  FirstBlock+Associativity-1; 

SizeType  Blockindex; 

SizeType  SubBlockIndex; 

CacheHit-No; 

BufferHit=Unknown; 

for  (BlockIndex-FirstBlock;  BlockIndex<=LastBlock;  BlockIndex++) 

{ 

if  (CacheBlockAddress [Blockindex] ==BlockAddress (RequestAddress) ) 

[ 

CacheHit=Yes; 
if  (Request==Read) 

{ 

for  (SubBlockIndex=SubBlock (RequestAddress)  ; 

SubBlockIndex<=SubBlock (RequestAddress+RequestSize-1) ; 
SubBlockIndex++) 

if  (CacheValidBit [Blockindex] [SubBlockIndex] ==No)  CacheHit=No 

} 

LastCacheBlockAccessTime [Blockindex] =Time; 

} 

} 


if  (CacheHit=»Yes)  BufferHit=No; 
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Cache . c 


ReadBit 


'  Description: 

t 

*  ReadHit  is  called  to  simulate  a  cache  hit  during  a  read  request. 

'  Read  Hit  simply  finishes  simulating  the  cache  access  for  the  hit. 

'  ReadCachHitTime  is  the  time  required  to  send  the  data  from  the  cache 

*  to  the  CPU.  Note  that  the  Ttime  to  locate  the  block  in  the  cache  is 
simulated  in  CacheModel.  ReadHit  is  called  repeatedly  while  Time  is 
incremented  until  Access  Cache  returns  with  CacheWaitingFor  equal  to 
Nothing.  AccessCache  will  return  CacheWaitingFor  equal  to 
ReadCacheRequest  until  the  ReadCacheHitTime  has  expired. 

***************«*******«'****'***********llr********»*************ilr*******4 


void  ReadHit ( ) 


AccessCache (ReadCacheHitTime, CacheWaitingForReadCacheRequest) ; 


Cache . c 
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ReadMlss 


Description: 


ReadMiss  is  called  to  simulate  a  cache  miss  during  a  read  request . 
ReadMiss  first  simulates  the  time  it  would  take  to  perform  all  block 
management  for  a  read  miss.  This  time  is  called  Read  Cache  Miss  Time. 
Once  that  time  has  passed  Read  Miss  calls  Select  Block  Victim  to  pick  a 
block  in  the  set.  When  SelectBlockVictim  returns  with  CacheWaitingFor 
equal  to  Nothing  the  Request  Block  Number  will  contain  the  new  block 
niimber  where  the  data  will  be  placed. 


Once  the  new  block  has  been  chosen,  ReadMiss  will  call 
AddToReadBuffer .  If  ReadForward  is  selected,  then  RequiredSize  for  the 
memory  request  will  be  equal  BlockSize.  The  RequiredSize  in  the  read 
memory  request  tells  the  MemoryModel  how  much  of  the  requested  data 
must  be  read  into  the  BlockBuffer  before  resetting  Cache  WaitingFor 
back  to  Nothing.  By  setting  RequiredSize  equal  to  BlockSize,  Read  Miss 
is  forcing  Memory  Model  to  read  in  the  entire  block  before  setting 
Cache  aiting  For  back  to  Nothing.  Once  the  Memory  Model  has  read  in 
the  data,  it  is  assumed  to  be  able  to  the  CPU  during  that  clock  cycle. 


void  ReadMiss 0 


AccessCache (ReadCacheMissTime, CacheWaitingForReadCacheRequest) ; 

if  (CacheWaitingFor==Nothing  | | 

CacheWaitingFor==CacheWaitingForFullWriteBuf fer) 

SelectBlockVictim  0  ; 

if  (CacheWaitingFor==Nothing  | | 

CacheWaitingFor==CacheWaitingForFullReadBuffer) 

if  (ReadForward==Yes) 

AddToReadBuffer (RequestAddress, 

BlockSize, 

RequestSize, 

RequestBlockNumber, 

ReadPriority) ; 

else 

AddToReadBuffer (RequestAddress, 

BlockSize, 

BlockSize, 

RequestBlockNumber, 

ReadPriority) ; 

if  (CacheWaitingFor==Nothing) 

CacheWaitingFor=CacheWaitingForReadMemoryRequest; 

} 

RecordStall (CacheWaitingFor) ; 

if  (CacheWaitingFor— CacheWaitingForReadMemoryRequest  && 
NoRequestsLeft (iReadBuffer) ) 

CacheWaitingFor-Nothing; 


} 


I 
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**  Cache. c  ** 

**  ** 

**  WriteHit  ** 

**  *•  V 

**  Description:  ** 

**  ** 


**  WriteHit  is  called  to  simulate  a  cache  hit  during  a  write  request.  ** 
**  Write  Hit  will  first  simulate  the  time  to  write  the  data  to  the  ** 
**  RequestBlockNumber  in  the  cache.  Note  that  the  time  tc  locate  the  ** 
**  block  was  simulated  by  CacheModel.  Once  WriteCacheHitTime  has  expired  ** 
**  then  WriteHit  will  perform  the  block  management  for  the  request.  The  ** 
**  block  management  is  dictated  by  the  WritePolicy.  For  a  WriteBack  ** 
**  policy  the  sub  blocks  written  to  must  have  their  dirty  bits  set.  This  ** 
**  is  done  by  SetDirtyBit.  For  a  WriteThrough  policy  the  request  must  be  ** 
**  set  to  the  write  buffer.  This  is  done  by  AddToWriteBuffer .  ** 
**  ** 
**************************************************#****»***********+H-********^ 


void  WriteHit () 


AddressType  TenpAddress; 

AccessCache (WriteCacheHitTime, CacheWaitingForWriteCacheRequest) ; 

if  (CacheWaitingFor==Nothing  I  I 

CacheWaitingFor>==CacheWaitingForFullWriteBuffer) 

( 

switch  (WritePolicy) 

case  WriteBack: 

{ 

SetDirtyBits () ; 
break ; 

} 

case  WriteThrough; 
i 

for  (TempAddress  =SubBlockAddress (RequestAddress+SubBlockSize-1)  ; 
TempAddress  <SubBlockAddress (RequestAddress+RequestSize)  ; 
TempAddress+=SubBlockSize) 

CacheValidBit [RequestBlockNumber] [SubBlock (TempAddress) ]=Yes; 
AddToWriteBuffer (RequestAddress,RequestSize, WritePriority)  ; 
break; 

) 

default : 

printf ("WritePolicy  not  defined  for  [WriteHit]  procedure."); 
exit  (1) ; 

} 

} 


} 
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WriteMiss 


Description:  ** 

★  # 

WriteMiss  is  called  to  simulate  a  cache  miss  during  a  write  ** 

request.  WriteMiss  will  first  simulate  the  time  needed  to  perform  ** 

all  block  management  requests.  The  time  is  called  WriteCacheMissTime .  ** 

This  is  only  the  time  required  to  make  the  requests,  not  the  time  ** 

required  to  complete  the  block  management  requests.  The  time  to  ** 

determine  that  a  miss  occurred  was  simulated  by  CacheModel.  Once  the  ** 
WriteCacheMissTime  has  expired,  then  WriteMiss  will  perform  all  block  ** 
management  recjuests.  The  memory  requests  are  dictated  by  the  ** 

WriteMissPolicy .  The  sinplest  policy  is  WriteAround.  For  a  ** 

WriteAround  policy  the  write  data  is  placed  in  the  WriteBuffer  by  ** 

AddToWriteBuffer .  WriteAllocate  however,  is  the  toughest  simulation  ** 

in  SACS.  WriteMiss  must  first  choose  a  block  to  put  the  new  data  in.  ** 
This  is  done  by  SelectBlockVictim.  Then  the  block  data  not  provided  ** 
by  the  write  has  to  be  read  in.  This  read  request  is  made  by  ** 

AddToReadBuffer .  Because  the  read  address  is  calculated  by  adding  the  ** 

request  size  to  the  address.  The  new  address  may  be  in  the  next  block  ** 

so  to  make  the  addition  modulo  the  BlockSize  may  have  to  be  subtracted.  ** 
When  the  read  request  has  been  make  then  the  sub  blocks  that  were  ** 

written  to  in  there  entirety  will  have  there  valid  bits  set.  If  only  ** 

part  of  a  sub  block  was  written  to  then  the  CacheValidBit  will  not  be  ** 
set.  ** 

** 

WriteMiss  then  uses  the  WritePolicy  to  dictate  how  the  write  data  ** 
is  to  update  the  memory.  For  a  WriteBack  policy  dirty  bits  are  set  by  ** 
SetDirtyBits .  For  a  WriteThough  the  data  is  added  to  the  WriteBuffer  ** 
by  AddToWriteBuffer.  ** 


void  WriteMiss () 


AddressType  Ten^jAddress; 

AccessCache (WriteCacheMissTime,  CacheWaitingForWriteCacheRequest )  ; 

switch  (WriteMissPolicy) 

( 

case  WriteAround: 

( 

if  (CacheWaitingFor==Nothing  | | 

CacheWaitingFor==CacheWaitingForFullWriteBuffer) 
AddToWriteBuffer (RequestAddress,  RequestSize,  WritePriority) ; 
break; 

} 

default : 

( 

printf ("WriteMissPolicy  not  defined  in  [WriteMiss]  procedure"); 
exit  (1) ; 

) 
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*  it 

Cache . c 

★  * 

irit 

irit 

WriteMiss 

irir 

continued 

irir 

*1^ 

irit 

case  WriteAllocate : 

if  (CacheWaitingFor==Nothing  | | 

CacheWaitingFor==CacheWaitingForFullWriteBuf fer) 

SelectBlockVictimO  ; 

if  (CacheWaitingFor=-Nothing  I  1 

CacheWaitingFor==CacheWaitingForFullReadBuffer) 

if  { (BlockSize-RequestSize) >0) 

if  (BlockAddress (RequestAddress+RequestSize) 

==BlockAddress (Request Address) ) 

AddToReadBu f f er (Reques t Addres s +Reques t S 1 ze , 
BlockSize-RequestSize, 

0, 

RequestBlockNumber, 
ReadForWriteAllocatePriority) ; 

else 

AddToReadBuf fer ( (RequestAddress+RequestSize) -BlockSize, 
BlockSize-RequestSize, 

0, 

RequestBlockNumber, 
ReadForWriteAllocatePriority) ; 

) 

if  ( (CacheWaitingFor==Nothing  | 1 

CacheWaitingFor“=CacheWaitingForFullWriteBuffer)  && 
CacheBlockAddress [RequestBlockNumber] ==BlockAddress (RequestAddress) ) 
{ 

for  (TempAddress  =SubBlockAddress (RequestAddress+SubBlockSize-1) ; 
TenqjAddress  <SubBloc)sAddress  (RequestAddress+RequestSize) ; 
TeinpAddress+=SubBlockSize) 

CacheValidBit [RequestBlockNvunber] [SubBlock (TempAddress) ]=Yes; 

switch  (WritePolicy) 

[ 

case  WriteBack: 

SetDirtyBits () ; 
break; 

case  WriteThrough : 

AddToWriteBuf fer (RequestAddress,  RequestSize,  WritePriority) ; 
break; 
default ; 

printf ("WritePolicy  not  defined  for  [WriteMiss]  procedure"); 
exit  (1) ; 

} 

} 

break; 

} 


) 
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AccessCache 


★  * 
*  * 
it  * 
*  ir 


**  Description:  ** 

**  ** 


**  AccessCache  is  called  to  simulate  a  the  CPU  accessing  the  cache. 

**  AccessCache  first  waits  for  the  cache  not  to  be  busy.  The  only  reason 
**  it  could  be  busy  is  if  the  BlockBuffer  is  in  the  process  of  updating 
**  the  cache.  During  this  time  AccessCache  will  return  CacheWaitingFor 
**  equal  to  CPUCacheAccess .  Once  the  cache  is  not  busy  then  CacheBusy  is 
**  set  to  Yes  locking  out  the  BlockBuffer  from  accessing  the  cache.  Then 
**  CacheWaitingFor  will  set  equal  to  WaitingForRequest  this  is  a  local 
**  variable  passed  by  the  caller.  It  will  either  be  equal  to 
**  ReadCacheAccess,  or  WriteCacheAccess .  Then  CacheBusy  is  set  for  the 
**  time  specified  by  RequestTime.  RequestTime  is  a  local  variable,  it 
**  could  equal  any  of  the  hit,  miss,  or  access  times.  Once  RequestTime 
**  has  expired  then  AccessCache  will  set  CacheBusy  equal  to  No,  and 
**  Cachewaiting  For  equal  to  Nothing. 
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*  * 
*  it 
it  * 


void  AccessCache (RequestTime, WaitingForRequest) 

Time Type  RequestTime; 

CacheWaitingForType  WaitingForRequest; 


static  TimeType  CacheTOA=0; 

if  (CacheBusy—Yes  &&  CacheWaitingFor==Nothing  ) 
CacheWaitingFor=CacheWaitingForCPUCacheAccess; 
if  (CacheBusy=-No  &&  CacheWaitingFor==CacheWaitingForCPUCacheAccess) 
CacheWaitingFor=Nothing; 

if  (CacheWaitingFor==Nothing) 

{ 

CacheBusy=Yes ; 

CacheWaitingFor=WaitingForRequest; 

CacheTOA=Time+RequestTime; 

} 

RecordStall (CacheWaitingFor) ; 

if  (CacheTOA<=Time  &&  CacheWaitingFor==WaitingForRequest) 

( 

CacheBusy=No; 

CacheWait ingFor=Nothing; 

} 


} 
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*♦  Cache,  c  ** 

*  *  ★  * 

**  SelectBlockVictim  ** 

**  ** 

**  Description:  ** 

**  ** 


**  SelectBlockVictim  chooses  the  next  block  t^  ‘^e  used,  and  writes 

**  the  dirty  subblocks  out  to  the  WriteBuffer.  Se  ::BlockVictim  first 
**  surveys  the  cache  set  that  the  HequestAddress  nv.,.o  to.  The  servey 
**  includes  finding  the  block  that  was  least  recently  accessed.  This 
**  BlockNumber  is  stored  in  LRUBlock.  Once  the  set  has  been  surveyed 
**  then  the  ReplacementPolicy  dictates  how  the  block  is  chosen.  For  the 
**  LRU  policy  Request  Block  Number  is  set  equal  to  LRUBlock.  For  the 
**  FIFO  policy  CacheNextBlock  keeps  track  of  the  next  victim  block  for 
**  each  set.  CacheNextBlock  is  initialized  to  all  zeros  during  the 
**  beginning  of  a  run.  Therefore  it  must  be  checked  to  see  if  it  is 
**  between  the  first,  and  last  blocks  for  the  set.  If  it  is  not  then 
**  CacheNextBlock  for  SetNumber  is  reset  to  FirstBlock.  Once 
**  SelectBlockVictim  knows  it  has  a  valid  Cache  Next  Block  then 
**  RequestBlock  is  set  equal  to  it.  Then  CacheNextBlock  for  the 
**  SetNumber  is  incremented.  For  RAND  policy  the  block  number  is  chosen 
**  randomly  from  all  the  blocks  in  the  set 
*  * 
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**  SelectBlockVictim  writes  all  dirty  sub  blocks  to  the  WriteBuffer  ** 
**  using  WriteDirtySubBlocks .  WriteDirtySubBlocks  takes  care  of  clearing  ** 
**  the  dirty  and  valid  bits  in  the  block.  Once  SelectBlockVictim  is  ** 
**  called  and  it  gets  to  the  bottom  of  the  function  with  Cache. .uitingFor  ** 
**  ecjual  to  Nothing  then  the  CacheBlockAddress  for  the  RequestBlockNumber  ** 
**  is  set  equal  to  the  block  address  of  RequestAddress .  ** 


void  SelectBlockVictim 0 
{ 

SizeType  SetNumber  =  Set (RequestAddress) ; 

SizeType  FirstBlock  =  SetNumber*Associativity; 

SizeType  LastBlock  =  FirstBlock+Associativity-1; 

SizeType  Blockindex; 

SizeType  SubBlockIndex; 


TimeType  LRUTime  =  Time+1; 

SizeType  LRUBlock; 


a* 

** 
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*  * 
** 

Irit 


Reque^tBlockNumber-FirstBlock; 

for  (BlockIndex=FirstBloc)c;  BloclcIndex<=LastBlock;  BlockIndex++) 

if  (CacheBlockAddress [Blockindex]— BlockAddress (RequestAddress) ) 
RequestBlockNumber-Blocklndex; 
if  (LRUTime>LastCacheBlockAccessTime [Blockindex] ) 

[ 

LRUTime*=LastCacheBlockAccessTime [Blockindex] ; 
LRUBlock-BlockIndex; 

} 


if  (CacheBlockAddress [RequestBlockNumber] ! =BlockAddress (RequestAddress) 


switch  (BlockReplacementPolicy) 


case  LRU: 

RequestBlockNuinber=LRUBlock; 

LastCacheBlockAccessTime [RequestBlockNumber] =Time; 
break; 

case  FIFO: 

if  (CacheNextBlock [SetNumber] <FirstBlock  1  I 
CacheNextBlock [ SetNumber ] >LastBlock  ) 

CacheNextBlock [SetNumber] =FirstBlock; 
RequestBlockNumber=CacheNextBlock [SetNumber ] ; 
if  (RequestBlockNumber<LastBlock) 

CacheNextBlock [SetNumber] ++; 
else 

CacheNextBlock [ SetNumber ] =FirstBlock; 
break; 

case  RAND: 

RequestBlockNumber= (randO  %Associativity) +FirstBlock; 
break; 


WriteDirtySubBlocks ()  ; 

} 

if  (CacheWa itingFor»»Nothing) 

CacheBlockAddress [RequestBlockNumber] -BlockAddress (RequestAddress) ; 


} 
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*  *  Cache . c  *  * 

**  ** 

**  SetDirtyBits  ** 

**  ** 

**  Description:  ** 

**  ** 

**  SetDirtyBits  sets  the  dirty  bits  for  all  sub  blocks  that  contains  ** 

**  data  that  was  modified  by  a  write  request.  ** 

**  ** 


void  SetDirtyBits 0 
{ 

SizeType  SubBlockIndex; 

for  (SubBlockIndex=SubBlock (RequestAddress) ; 

SubBlockIndex<=SubBlock (RequestAddress+RequestSize-1) ; 
SubBlockIndext+) 

CacheDirtyBit [RequestBlockNumber] [SubBlockIndex ]=Yes; 

} 
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WriteDirtySubBlocks 


Description: 


**  WriteDirtySubBlocks  is  called  to  simulate  writing  all  the  dirty  *’ 

**  sub  blocks  in  RecjuestBlock.  WriteDirtySubBlocks  not  only  clears  all 
**  the  dirty  bits.  It  also  clears  all  the  valid  bits.  *■> 

**  WriteDirtySubBlocks  prepares  a  block  to  receive  new  data,  and  is  called 
**  after  a  block  has  been  selected  as  a  victim.  WriteDirtySubBlocks  will 
**  search  the  block  for  consecutive  dirty  blocks  and  splice  them  together 
**  into  one  write  request.  The  write  request  is  then  added  to  the  *■' 

**  WriteBuffer.  All  of  the  sub  blocks  that  make  up  the  request  will  have 
**  their  dirty  and  valid  bits  cleared.  This  process  of  searching  and  *’ 

**  writing  is  repeated  until  all  the  bits  are  not  dirty.  Then  all  the 
**  valid  bits  are  cleared. 

*★  *1 

void  WriteDirtySubBlocks 0 


SizeType 

SizeType 


SubBlockIndex 


AddressType  MemoryRequestAddress 
SizeType  MemoryRequestSize 
PriorityType  MemoryRequestPriority 


CacheBlockAddress [RequestBlockNumber] ; 
0/ 

WriteDirtyBlockPriority; 
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**  Cache. c  ** 
★  ★  ★★ 

**  WriteDirtySubBlocks  ** 
**  continued  ** 


do 

MemoryRequestSize-0; 

while  ( (CacheDirtyBit [RequestBlockNumber] [SubBlockIndex] ==No  II 
CacheValidBit [RequestBlockNumberj [SubBlockIndex] ==No)  && 
SubBlockIndex<NuniberOf  SubBlocks ) 

SubBlockIndex++; 

MemoryReq[uestAddress=CacheBlockAddress (RequestBlockNumber ] 

+SubBlockIndex*SubBlockSi2e; 

while  (CacheDirtyBit [RequestBlockNumber J [SubBlockIndex] ==Yes  && 
SubBlockIndex<NuinberOf  SubBlocks) 

[ 

MemoryRequestSize+*=WordSize; 

SubBlockIndex++; 

} 

if  (MemoryRequestSize) 

[ 

AddToWriteBuffer (MemoryRequestAddress, 

MemoryRequestSize, 

MemoryRequestPriority) ; 
if  (CacheWaitingFor==Nothing) 

for  (i=0;  i<*SubBlockIndex  &&  i<NumberOf SubBlocks;  i++) 
CacheDirtyBit [RequestBlockNiunber] [i]=No; 

} 

} 

while  (SubBlockIndex<NumberOfSubBlocks  &&  CacheWaitingFor==Nothing) ; 

if  (CacheWaitingFor*“Nothing) 

for  (i“0;  i<NumberOf SubBlocks;  i++) 

CacheValidBit  [RequestBlockN\imb‘»r]  [i]=No; 


} 
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**  Cache. c  ** 

**  ** 

**  AddToReadBuffer  ** 

**  ★* 

**  Description:  ** 

**  ** 


**  AddToReadBuffer  takes  the  elements  of  a  request,  and  adds  the  ** 
**  request  to  the  ReadBuffer.  It  will  perform  all  of  the  searches,  and  ** 
**  updates  necessary  to  support  the  appropriate  scoreboarding  protocals.  ** 


♦  « 
*  * 
■*  * 

★  ♦ 
•k  ir 
★  ★ 
it* 
it  it 
it  it 

*  it 

*  it 
it  it 
it  it 
kit 
kit 
kk 
k  k 
k  k 
kk 
kk 
kk 
k  k 
k  k 
kk 
k  k 
k  k 

*  k 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 
kk 
kk 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 
k  k 


AddToReadBuffer  will  begin  by  searching  the  cache,  and 
BlockBuffer  for  each  byte  in  the  request  starting  at  the  beginning  of 
the  request.  Every  time  a  byte  is  found  in  one  or  the  other  then  the 
Address  is  incremented,  while  Size  and  RequiredSize  are  decremented. 
This  simulates  removing  the  available  data  from  the  front  of  the 
request.  Then  AddToReadBuffer  will  search  the  cache,  and  BlockBuffer 
for  the  data  at  the  end  of  the  request.  Every  time  a  byte  is  found 
then  the  Size  of  the  request  is  decremented  by  one.  If  the  byte  was  a 
required  byt  then  the  RequiredSize  is  decremented  also.  This  simulates 
removing  any  data  available  from  the  end  of  the  request . 

AddToReadBuffer  is  either  left  with  a  request  that  has  a  Size  equal  to 
zero  or  the  end  points  are  both  needed  from  memory.  If  the  RequiredSize 
is  zero  then  the  request  is  a  buffer  hit,  otherwize  the  request  is  a 
buffer  miss.  If  the  request  is  already  a  cache  hit  then  the  buffer 
hit  is  for  some  block  management  request.  These  kinds  of  buffer  hits 
are  not  recorded  because  it  would  confuse  the  ResultsDisplay,  by  making 
it  possible  to  get  a  hit  rate  greater  tha  100%.  If  the  Size  is  not 
zero  and  Remove  ReadDuplicates  is  eaual  to  No  then  the  request  is 
added  to  the  end  of  the  ReadBuffer  using  Append.  Append  is  a  buffer 
utility  that  adds  the  request  to  the  end  of  the  buffer.  The  request 
must  be  added  to  the  end  of  the  buffer  in  ouder  not  to  interfere  with 
MemoryModel  which  maybe  in  the  middle  of  a  memory  read.  If 
RemoveReadDuplicates  is  equal  to  Yes  then  the  first  byte  in  the  request 
will  be  spliced  into  the  Read  Buffer. 

Splice  is  another  buffer  utility.  Splice  will  first  search  the 
ReadBuffer  for  the  byte  if  it  cant' t  find  a  request  in  the  buffer  that 
contains  the  byte  then  it  will  search  for  a  read  request  that  is 
getting  data  from  the  same  block.  If  one  is  found  then  the  request  is 
modified  to  include  the  new  read  byte  request.  If  no  suitable  request 
can  be  found  then  Splice  will  add  a  one  byt  request  to  the  Read  Buffer. 
The  Address  is  then  incremented  while  the  Size,  and  Required  Size  are 
decremented.  Then  the  cache,  and  BlockBuffer  are  searched  for  the  next 
byte.  If  it  is  not  found  then  the  next  byte  is  spliced  into  the 
ReadBuffer.  This  process  is  repeated  until  all  of  the  bytes  of  the 
request  have  either  been  spliced  into  the  ReadBuffer  or  found. 

The  BufferHit  is  normally  defined  as  when  the  data  is  available 
but  in  the  cache.  However  in  order  to  support  the  testing  of  SACS, 
the  definition  of  a  buffer  hit  is  redefined  to  mean  that  a  request  was 
found  to  have  accrued  recently,  and  that  given  time  to  complete  all 
block  management  the  requested  data  would  have  been  in  the  cache. 

This  allows  TestSACS  to  predict  the  hits  of  a  test  run  without  taking 
into  account  the  time  in  takes  to  preform  the  block  management. 
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**  Every  time  a  request  is  spliced  into  the  read  or  write  buffers 

♦*  then  the  TimeToExecute,  and  CompletionTirceExtamate  must  be 
♦♦  recalculated.  The  new  time  estimates  are  performed  by 
♦*  CalculateTimeEstimates . 
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void  AddToReadBu£f er (Address, Size, RequiredSize, Block, Priority) 

AddressType  Address; 

SizeType  Size; 

SizeType  RequiredSize; 

SizeType  Block; 

PriorityType  Priority; 

{ 

MemoryRequestType  ReadMemoryRequest ; 

YesNoType  FoundByte; 

AddressType  ByteAddress; 

AddressType  CurrentBlockAddress 

Bu££erSizeType  01dReadBu££erNext 

ReadMemoryRequest  .Address  =>  Address; 

ReadMemoryRequest . Size  =  Size; 

ReadMemoryRequest .RequiredSize  «  RequiredSize; 

ReadMemoryRequest. Block  =  Block; 

ReadMemoryRequest. Priority  =  Priority; 

ReadMemoryRequest .AccessInProgress  =  No; 

ReadMemoryRequest. TimeToExecute  =  0; 

ReadMemoryRequest .CompletionTimeEstiroate  »  0; 


=  BlockAddress (Address) ; 
»  ReadBu££er .Next; 
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AddToReadBu  ££er 
continued 
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** 


i£  (CacheWaitingFor==CacheWaitingForFullReadBu££er)  CacheWaitingFor=Nothing 
FoundBy te“Yes ; 

while  (FoundByte=“Yes  &&  Size>0) 

{ 

FoundByte-No; 

i£  (SearchCache (Address) “Yes) 

FoundByte-Yes ; 

else  if  (SearchBlockBu££er“Yes  &&  Search (&BlockBuffer,  Address)) 
FoundByte=Yes ; 
if  (FoundByte“Yes) 

( 

Address++; 

if  (BlockAddress (Address) !=CurrentBlockAddress)  Address— BlockSize; 
if  (Size>0)  Size — ; 
if  (RequiredSize>0)  RequiredSize — ; 

} 

} 

ByteAddress“Address+Size-l; 

if  (BlockAddress (ByteAddress) !«CurrentBlockAddress)  ByteAddress-=BlockSize; 
FoundByte=Yes; 

while  (FoundByte“Yes  &&  Size>0) 

FoundByte=No; 

if  (SearchCache (ByteAddress) “Yes) 

FoundBy te=Yes ; 

else  if  (SearchBlockBuffer“Yes  &&  Search (fcBlockBuffer,  ByteAddress)) 
FoundBy t  e-Yes ; 
if  (FoundByte“Yes) 

( 

ByteAddress — ; 

if  (BlockAddress (ByteAddress) !=CurrentBlockAddress) 
ByteAddress+=BlockSize; 
if  (Size>0)  Size — ; 

if  (RequiredSize>Size)  RequiredSize*Size; 

) 

} 

if  (Request“Read  &&  Test“No) 

( 

if  (RequiredSize“0  &&  CacheHit“No) 

Buf  f erHit=Yes ; 
else 

BufferHit“No; 

) 

if  (RequiredSize“0  &&  Request“Read)  CacheWaitingFor=Nothing; 

ReadMemoryRequest .Address  -  Address; 

ReadMemoryRequest .Size  -  Size; 

ReadMemoryRequest .RequiredSize  =  RequiredSize; 

if  (RemoveReadDuplicates“No  &&  Size>0) 

Append ((ReadBuffer, & ReadMemoryRequest) ; 
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**  AddToReadBuffer  ** 
**  continued  ** 
**  ** 


while  (Si2e>0  &&  RemoveReadDuplicates==Yes) 

FoundByte-No; 

if  (SearchCache (Address) -»Yes) 

FoundByte=Yes ; 

else  if  (SearchBlockBuffer—Yes  &&  Search (iBlockBuffer,  Address)) 
FoundByte-Yes ; 

if  (FoundByte—No) 

Splice (SReadBuf fer, Address, RequiredSize, Block,  Priority)  ; 
Address++; 

if  (BlockAddress (Address) ! =CurrentBlockAddress)  Address-=BlockSize; 
if  (Size>0)  Size — ; 
if  (RequiredSize>0)  RequiredSize — ; 

} 

if  (Request^Read  &&  Test==Yes) 

{ 

if  (ReadBuffer .Next“01dReadBufferNext  &&  CacheHit=»No) 
BufferHit-Yes; 
else 

BufferHit“No; 

} 

CalculateTimeEstimates ()  ; 


} 


** 
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**  Description:  ** 

**  ** 


**  SearchCache  is  called  by  AddToReadBuffer  to  find  any  parts  of  ** 
**  the  request  that  may  be  already  located  in  the  cache.  This  must  be  ** 
**  done  because  if  a  read  request  follows  a  write  request  using  a  write  ** 
**  allocate  policy  then  part  of  the  read  may  be  in  the  cache  while  the  ** 
**  rest  may  still  need  to  be  read  from  memory.  Search  Cache  checks  all  ** 
**  CacheBlockAddresses  in  the  cache  set.  If  any  of  the  cache  block  ** 
**  addresses  equals  the  block  address  of  the  byte,  then  Search  Cache  ** 
**  checks  the  CacheValidBit  for  the  sub  block  that  the  byte  is  located  in.  ** 
**  If  the  sub  block  is  valid  then  SearchCache  returns  Yes.  ** 
**  *■* 


YesNoType  SearchCache (Address) 

AddressType  Address; 

( 

SizeType  FirstBlock  =  Set (Address) ‘Associativity; 
SizeType  LastBlock  =  FirstBlock+Associativity-1; 
SizeType  Blockindex; 

YesNoType  FoundByte; 


for  (Blocklndex=FirstBlock;  BlockIndex<=LastBlock;  BlockIndex++) 
if  (CacheBlockAddress [Blockindex] ==BlockAddress (Address) ) 

if  (CacheValidBit (Blockindex] (SubBlock (Address) ] )  FoundByte=Yes; 

return (FoundByte) ; 


) 
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**  AddToWriteBuffer  ** 
**  •  ** 

**  Description:  ** 
**  ** 

**  AddToWriteBuffer  adds  one  record  to  write  buffer.  It  also  updates  ** 
**  the  ReadBuffer  it  the  UpdateReadBuffer  arguments  is  asserted.  The  ** 
**  process  of  updating  the  ReadBuffer  is  sinply  changein  the  requests  so  ** 
**  that  data  make  available  by  the  write  request  is  not  requested  form  ** 
**  memory.  UpdateReadBuffer  should  not  be  used  unless  the  word  and  sub  ** 
**  block  sizes  are  equal.  This  is  because  a  write  request  may  reduce  a  ** 
**  read  request  to  where  the  read  request  will  not  be  large  enough  to  ** 
**  validate  a  sub  block.  The  write  request  may  alsobe  unable  to  set  any  ** 
**  valid  bits  because  of  sub  block  alignment.  The  result  is  that  a  sub  ** 
**  block  was  supposed  to  be  read  in  is  not.  ** 


void  AddToWriteBuffer (Address,  Size,  Priority) 

AddressType  Address; 

SizeType  Size; 

PriorityType  Priority; 


MemoryRequestType 

YesNoType 

AddressType 

AddressType 

SizeType 

Buf ferSizeType 


Wr iteMemoryRequest ; 

FoundByte; 

ByteAddress; 

CurrentBlockAddress 

NoBytes; 

OldWriteBuf ferNext 


BlockAddress (Address) ; 
WriteBuf f er . Next ; 


WriteMemoryRequest .Address 
WriteMemoryRequest . Size 
WriteMemoryRequest .RequiredSize 
WriteMemoryRequest .Block 
WriteMemoryRequest .Priority 
WriteMemoryRequest . Access InProgress 
WriteMemoryRequest . TimeToExecute 
WriteMemoryRequest .CompletionTimeEstiraate 


Address; 

Size; 

0; 

0; 

Priority; 

No; 

0; 

0; 
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**  AddToWriteBuffer 

**  continued 

★  ♦  ★tI 


if  (CacheWaitingFor==CacheWaitingForFullWriteBuffer) 
CacheWaitingFor=Nothing; 

FoundByte=yes; 

while (FoundByte»=yes  &&  UpdateReadBuffer=“Yes) 

FoundBy te»No ; 

By t eAddr es s-Addr es s ; 

for  (NoBytes“0;  NoBytes<Size;  NoBytes++) 

{ 

if  (UpdatingReadBuffer (ByteAddress)==Yes)  FoundByte=Yes; 
By t  eAddr e  s  s ++ ; 

if  (BlockAddress (ByteAddress) ! =CurrentBlockAddress) 
ByteAddress— 'BlockSize; 


if  (ReinoveWriteDuplicates==No  &&  Size>0) 

Append (iWriteBuffer,  sWriteMemoryRequest) ; 

while  (RemoveWriteDuplicates==Yes  &&  Size>0) 

{ 

Splice (sWriteBuffer, Address, 0, 0, Priority) ; 

Address++; 

if  (BlockAddress (Address) ! =CurrentBlockAddress)  Address-=BlockSize; 
if  (Size>0)  Size — ; 


if  (Request—Write) 

{ 

BufferHit=No; 

if  (WriteBuffer .Next==01dWriteBufferNext  &&  CacheHit==No)  Buf ferHit=Yes; 
if  (WriteBuffer.Next==01dWriteBufferNext  && 

CacheWaitingFor  ! =CacheWaitingForFullWriteBuf fer) 
CacheWaitingFor=Nothing; 


CalculateTimeEstimates () ; 
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Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified;  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 

Address:  Electrical  Engineering  Department 
Naval  Postgraduate  School 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  above  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  William  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  implied, 
with  respect  to  this  software's  ability  to  produce  valid  results. 

This  program  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user. 
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Memory. c  contains  all  functions  that  relate  to  the  simulation  of 
main  memory .  Memory  Model  makes  all  the  necessary  calls  to  simulate 
main  memory.  MemoryModel  decides  which  calls  to  make,  based  on 
MemoryWaitingFor .  This  function  is  called  every  time  Time  is 
incremented.  If  there  are  no  read  or  write  requests  waiting  to  be 
completed,  the  function  does  nothing.  Memory  Model  contains  a  loop 
that  forces  the  procedure  to  continue  modeling  until  TOA  and  TOD  are 
not  equal  to  Time.  This  insures  that  if  there  are  any  events  that 
occur  in  zero  clock  cycles  then  the  next  event  is  allowed  to  start . 

Memory  Model  calls  SelectMemoryRequest  to  choose  a  request  from 
either  the  read  or  the  write  buffers.  Memory  Model  calls  Start  Reads, 
and  Start  Writes,  to  simulate  accessing  memory  and  receiving  the  first 
word  of  a  memory  request .  ContinueMemoryReads,  and 
ContinueMemoryWrites  are  then  called  to  simulate  the  memory  transfer 
of  the  following  words  of  data. 

The  simulation  of  main  memory  includes: 

Choosing  memory  request  from  read,  write  buffers. 

Simulated  memory  access  times. 

Simulated  memory  transfer  times. 

Cache  Update  after  memory  read. 
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Description; 


This  is  a  list  of  function  declarations  within  the  file  scope 
**  of  Memory. c 


*  it 

*  it 
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void  MemoryModel ( ) ; 

/* 
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*/ 

void  SelectMemoryRequest ( ) ; 

/* 
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void  StartMemoryReads ( ) ; 

/* 
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void  ContinueMemoryReads () ; 

/* 
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void  StartMemoryWrites ( ) ; 

/* 
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void  ContinueMemoryWrites () ; 

/* 
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void  UpdateCache () ; 

/* 

Page 

5-11 

*/ 

void  AddAWordToMemoryRecjuest  ()  ; 

/* 
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void  RemoveAWordFromMemoryRequest () ; 

/* 
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Description: 


Memory. c  contains  all  functions  that  relate  to  the  simulation  of 
main  memory.  Memory  Model  makes  all  the  necessary  calls  to  simulate 
main  memory.  MemoryModel  decides  which  calls  to  make,  based  on 
MemoryWaitingFor .  This  function  is  called  every  time  Time  is 
incremented.  If  there  are  no  read  or  write  requests  waiting  to  be 
coirpleted,  the  function  does  nothing.  Memory  Model  contains  a  loop 
that  forces  the  procedure  to  continue  modeling  until  TOA  and  TOD  are 
not  equal  to  Time.  This  insures  that  if  there  are  any  events  that 
occur  in  zero  clock  cycles  then  the  next  event  is  allowed  to  start. 

Memory  Model  calls  SelectMemoryRequest  to  choose  a  request  from 
either  tht  read  or  the  write  buffers.  Memory  Model  calls  Start  Reads, 
and  Start  Writes,  to  simulate  accessing  memory  and  receiving  the  first 
word  of  a  memory  request.  ContinueMemoryReads,  and 
ContinueMemoryWrites  are  then  called  to  simulate  the  memory  transfer 
of  the  following  words  of  data. 

The  simulation  of  main  memory  includes: 

Choosing  memory  request  from  read,  write  buffers. 

Simulated  memory  access  times. 

Simulated  memory  transfer  times. 

Cache  Update  after  memory  read. 
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void  MemoryModel 0 


Memory Wait ingForType  LastMemoryWaitingFor; 
do 


i 

LastMemoryWaitingFor=MemoryWaitingFor; 

if  (MemoryWaitingFor==Nothing)  SelectMemoryRequest (SMemoryWaitingFor) ; 

else  if  (MemoryWaitingFor==MemoryWaitingForMemoryReadRequest  I  1 
MemoryWaitingFor=>=MemoryWaitingForCacheUpdate) 
StartMemoryReads () ; 

else  if  (MemoryWaitingFor==MemoryWaitingForMemoryReadAccess  |  ( 

Memory Wait ingFor==MemoryWaitingForMemoryReadTransfer) 
ContinueMemoryReads () ; 

else  if  (MemoryWaitingFor==MemoryWaitingForMemoryWriteRec[uest) 
StartMemoryWrites ()  ; 

else  if  (MemoryWaitingFor==MemoryWaitingForMemoryWriteAcce3S  I  I 
MemoryWaitingFor==«MemoryWaitingForMemoryWriteTransfer) 
ContinueMemoryWrites () ; 

} 

while  (MemoryWaitingFor '.“LastMemoryWaitingFor  |1  TOA==Time  II  TOD==Time); 


} 
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*  *  Memory .  c  *  * 

**  ** 

**  SelectMemoryRequest  ** 

★  ** 

**  Description:  ** 

**  ** 

**  SelectMemoryRequest  is  called  when  memory  is  waiting  for  nothing.  ** 

**  SelectMemoryRequest  chooses  a  request  from  either  the  read  or  write  ** 

*•  buffers,  based  on  priority.  The  request  is  not  returned  however,  the  ** 

**  request  is  left  at  the  top  of  the  buffer  with  its  Priority  and  ** 

**  Accessinprogress  set  equal  to  Yes.  If  a  request  is  found  then  ** 

**  MemoryWaitingFor  is  set  to  MemoryReadRequest,  or  MemoryWriteRequest  ** 

**  depending  on  whether  the  request  was  found  in  the  read  or  write  ** 

**  buffers.  ** 

**  ** 


void  SelectMemoryRequest (MemoryWaitingFor) 

MemoryWaitingForType  ‘MemoryWaitingFor; 

{ 

MemoryRequestType  ReadMemoryRequest; 

MemoryRequestType  WriteMemoryRequest ; 

if  (! (ReadBuffer. Empty ) ) 

ReadMemoryRequest=View (iReadBuf fer) ; 
else 

ReadMemoryRequest .Priority=NoPriority; 

if  ( !  (WriteBuffer  .Eirpty) ) 

WriteMemoryRequest=View (swriteBuffer) ; 
else 

WriteMemoryRequest . Priority=NoPriority ; 

if  (ReadMemoryRequest .Prior ity<=WriteMemoryRequest .Priority  && 
ReadMemoryRequest .Priority ! =NoPriority ) 

( 

*MemoryWaitingFor=MemoryWaitingForMemoryReadRequest; 
ReadMemoryRecjuest  .Access  InProgress=yes; 

ReadMemoryRequest .  PriorityO ; 

ChangeTopMemoryRequest (SReadBuffer, SReadMemoryRequest)  ; 

} 

else  if  (WriteMemoryRequest .Priority l-NoPriority) 

{ 

*MemoryWaitingFor=MemoryWaitingForMemoryWriteRequest ; 
WriteMemoryRequest . Access InProgress-Yes; 

WriteMemoryRequest .Priority=0; 

ChangeTopMemoryRequest (sWriteBuffer, & WriteMemoryRequest) ; 

} 


} 


**  Page  5-  5  ** 


**  Memory. c  ** 

**  ,  ** 

**  StartMemoryReads  ** 

**  ** 


**  Description:  ** 

**  ** 


**  StartMemoryReads  begins  a  read  request,  simulating  the  first  word 

**  read  from  memory.  The  time  to  complete  this  read  is  called 
**  MemoryAccessTime.  The  BlockBuffer  is  initialized  in  preparation  to 
**  receive  the  new  data  words,  if  BlockWaitingFor  is  not  equal  to 
**  Nothing  the  StartMemoryReads  will  have  to  wait  until  it  is  before 
**  allowing  the  new  memory  read  request  to  start.  If  StartMemoryReads 
**  does  have  to  wait  for  the  cache  then  Memory Wait ingFor  it  set  equal  to 
**  CacheUpdate,  otherwise  MemoryWaitingFor  is  set  to  MemoryReadAccess . 

**  The  new  block  record  is  equal  to  the  ReadBuffer  with  its  sizes  set  to 
**  zero.  This  gives  the  Block  Memory  Request  the  same  block  number  and 
**  the  ReadMemoryRequest .  The  Address  is  aligned  to  WordSize.  The 
**  Address  must  be  aligned  because  the  words  read  in  will  be  aligned 
•*  to  WordSize.  The  new  BlockMemoryRequest  is  simply  pushed  onto  the 
**  Block  Buffer.  The  BlockWaitingFor  is  set  equal  to  MemoryBlockTransfer . 
**  To  indicate  that  data  is  being  transferred  from  memory  to  the 
**  BlockBuffer. 


★  ★ 
★  ★ 

★  ★ 

it* 

** 

*it 

it 

*  * 

*  it 


void  StartMemoryReads 0 


MemoryRequestType  ReadMemoryRequest ; 

MemoryRequestType  BlockMemoryRequest; 

if  (BlockWaitingFor=*»Nothing) 

ReadMemoryRequest=View (sReadBuf fer) ; 

TOA=Time+MemoryAcces  s  Time ; 

MemoryWaitingFor=MemoryWaitingForMemoryReadAccess; 

BlockMemoryRequest=ReadMemoryRec[uest; 

BlockMemoryRequest  .Address=«WordAddress  (ReadMemoryRequest  .Address)  ; 
BlockMemoryRequest . Size-0; 

BlockMemoryRequest .RequiredSize-0; 

BlockMemoryRequest .Priority-0; 

BlockMemoryRequest .AccessInProgress=No; 

Push (iBlockBuf fer, &BlockMemoryRequest) ; 

BlockWaitingFor-MemoryBlockTransfer; 

} 

else 

{ 

MemoryWaitingFor-MemoryWaitingForCacheUpdate; 

) 


} 


Memory . c 


Page  5-  6 


Cont  inueMemoryReads 


'*  Description: 


ContinueMemoryReads  continues  the  memory  read  request  started  by 
StartMemoryReads .  It  simulates  every  read  from  memory  other  than  the 
first  word  which  was  simulated  by  StartMemcryReads .  The  time  to 
conplete  each  word  transfer  is  equal  to  MemroyTransferTime.  The  block, 
and  read  buffers  are  altered  every  time  a  word  is  read  from  memory. 
Once  a  request  is  conplete,  it  is  removed  from  the  Read  Buffer,  and 
Memory  WaitingFor  is  reset  to  Nothing.  Block  Waiting  For  is  set  to 
BlockCacheAccess  in  preparation  to  transfer  the  new  data  to  the  cache. 
If  the  ConpletionTimeEstimate  for  the  memory  read  request  is  not  equal 
to  Time  then  a  time  predition  error  is  rased. 


void  ContinueMemoryReads 0 


MemoryRequestType  BlockMemoryRequest; 
MemoryRequestType  ReadMemoryRequest ; 

if  (TOA<“Time) 


BlockMemoryRequest=View (iBlockBuf fer) ; 

AddAWordToMemoryRequest (iBlockMemoryRequest) ; 

ChangeTopMemoryRequest (SBlockBuf fer, SBlockMemoryRequest) ; 

ReadMemoryRequest=View (SReadBuf fer) ; 

RemoveAWordFromMemoryRequest (SReadMemoryRequest) ; 

if  (ReadMemoryRec[uest.Size>0) 

ChangeTopMemoryRequest  (&ReadBuffer,  SReadMemoryRequest)  ; 
TOA=Time+MemoryTransferTime; 

MemoryWaitingFor=MemoryWaitingForMemoryReadTransfer; 

} 

else 

Pop (SReadBuf fer) ; 

TOA-0; 

if  (Time!=ReadMemoryRequest .CompletionTimeEstimate) 

PrintTimePredictionError  (ReadMemoryRequest .  ConpletionTimeEstimate, 

Time, 

"Read", 

" Cont inueMemoryReads " ) ; 

MemoryWaitingFor=Nothing; 

BlockWait ingFor=BlockCacheAccess ; 

BlockTOA=Time+Buf ferCacheAccessTime; 

TotalNumberOfWordsReadFromMemory++; 


} 


*-* 
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Memory . c 

Cont inueMemoryReads 

** 

continued 

it* 

it* 

** 

else 


ReadMemoryRequest*«View  (&ReadBuf  £er) ; 

if  (ReadMemoryRequest.Size—O) 

Pop(&ReadBuffer) ; 

TOA-0; 

if  (Time ! =ReadMemoryRequest . Complet ionTimeEstimate ) 

PrintTimePredictionError (ReadMemoryRequest.Coirplet ionTimeEstimate, 

Time, 

"Read", 

" ContinueMemory Reads " ) ; 

MemoryWait ingFor-Not hing ; 

BlockWaitingFor-BlockCacheAccess; 

BlockTOA=Time+BufferCacheAccessTime; 

} 


void  StartMemoryWrites 0 
{ 

if  (MemoryWaitingFor=-MenioryWaitingForMemoryWriteRequest ) 
TOD=Tiine+MemoryAccessTime  ; 

MemoryWaitingFor=MemoryWaitingForMemoryWriteAccess; 

} 

} 
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Cont inueMemoryWrit es 


Description: 


ContinueMemoryWrites  continues  the  memory  write  request  started 
by  StartMemoryWrites .  Like  ContinueMemoryReads,  it  simulates  every 
write  to  mwmory  other  than  the  first  word  which  was  simulated  by 
StartMemroyWrites .  The  time  to  complete  each  word  transfer  is  equal 
to  MemoryTransferTime.  The  Write  Buffer  is  altered  every  time  a  word 
is  written  to  memory.  Once  the  memory  write  recpiest  is  conplete,  it 
is  removed  form  the  WriteBuffer,  and  MemoryWaitingFor  is  reset  to 
Nothing.  If  the  CompletionTimeEstimate  for  the  memory  read  request  is 
not  equal  to  Time  when  the  request  is  conpleted  then  a  time  predition 
error  is  rased. 


** 
it* 
** 
** 
** 
** 
** 
** 
** 
*  * 
** 
** 
** 
** 
** 
** 


void  ContinueMemoryWrites 0 
{ 

MemoryRequestType  WriteMemoryRequest; 

if  (TOD<=Time) 

{ 

WriteMemoryRequest=View (&WriteBuf fer) ; 

RemoveAWordFromMemoryRequest (& WriteMemoryRequest) ; 
if  (WriteMemoryReq[uest.Size>0) 

ChangeTopMemoryRequest (SWriteBuf fer, SWriteMemoryRequest) ; 
TOD-Time+MemoryTrans  f erTime ; 

MemoryWaitingFor*MemoryWaitingForMemoryWriteTransfer; 

} 

else 

{ 

Pop(SWriteBuffer) ; 

TOD=0; 

i f  (Time ! “WriteMemoryRequest . Con^jletionTimeEstimate ) 

PrintTimePredictionError (WriteMemoryRequest . ConpletionTimeEstimate, 

Time, 

"Write", 

"ContinueMemoryWrites") ; 

MemoryWaitingFor=Nothing; 

) 

TotalNumberOfWordsWrittenToMemory++; 

} 
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** 

It* 


ContinueMemory  Writes 
continued 


** 


else 

{ 

WriteMemoryRequest-View (&WriteBuf fer) ; 
if  (WriteMemoryRequest.Size—0) 

Pop(&WriteBuf£er) ; 

TOD-0; 

if  (Time ! -WriteMemoryRequest . ConpletionTimeEstimate ) 

PrintTimePredictionError  (WriteMemoryRequest .  ConpletionTimeEstimate, 

Time, 

"Write", 

"ContinueMemoryWrites") ; 

MemoryWaitingFor-Nothing; 

} 

} 

} 
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Description: 


UpdateCache  simulates  entering  data  from  the  BlockBuffer  into  the 
cache.  UpdateCache  first  checks  wheter  of  not  the  cache  is  busy.  If 
it  is  not  then  CacheBusy  is  asserted,  and  BlockWaitingFor  is  set  equal 
to  BlockCacheTransfer .  The  BlockTOA  is  calculated,  to  enable 
CalculateTimeEstimates  to  predict  the  conpletion  times  for  additional 
memory  read  request  in  the  buffer.  If  the  cache  is  busy  then  the 
previous  memory  request  time  completions  may  be  wrong.  That  is  because 
the  last  estimates  conunted  on  the  old  BlockTOA.  This  means  that  all 
the  time  estimates  must  be  recalculated. 

Once  the  BufferCacheAccessTime  has  expired  then  BlockWaitingFor 
is  set  equal  to  Nothing,  and  the  CacheBusy  is  deserted.  The  read  data 
must  then  be  removed  from  the  BlockBuffer.  The  appropriate  sub  blocks 
in  the  cache  will  then  have  there  dirty  bits  cleared,  and  valid  bits 
set . 
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void  UpdateCache 0 

MemoryRequestType  BlockMemoryRequest ; 
AddressType  TenpAddress; 
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**  Memory. c  ** 

**  It* 


** 

** 

** 


UpdateCache 

continued 


** 

** 


if  (BlockWaitingFor—BlockCacheAccess  &&  CacheBusy“Yes) 

BlockTOA-Time+BufferCacheAccessTime+1; 

CalculateTimeEstimates  0 ; 

} 

if  (BlockWaitingFor—BlockCacheAcceas  &&  CacheBusy—No) 

CacheBusy-Yes ; 

BlockTOA=Time+BufferCacheAccessTime; 

BlockWait ingFor-BlockCacheTrans  f er ; 

) 

if  (BlockWaitingFor==BlockCacheTransfer  &&  BlockTOA<=Time) 

{ 

CacheBusy-No; 

BlockWait ingFor-Nothing; 

BlockTOA-0; 

BlockMemoryRequest«Pop (&BlockBuf fer) ; 
if  (CacheBlockAddress [BlockMemoryRequest .Block] “ 

BlockAddress (BlockMemoryRequest .Address) ) 

{ 

for  (TempAddress-BlockMemoryRequest  .Address; 
TeinpAddress<-BlockMemoryRequest  .Address 
■fBlockMemoryRequest .  Size-1; 
Ten?5Address+=SubBlockSi2e) 

CacheDirtyBit  [BlockMemoryRequest. Block]  [SubBlock(TeiipAddress)  ]=No; 
CacheValidBit  [BlockMemoryRequest  .Block]  [SubBlock  (TenpAddress)  ]=Yes 
) 

} 

} 

else 

( 

BlockMemoryRequest“View (SBlockBuf fer) ; 

BlockMemoryRequest . TimeToExecute=Buf f erCacheAccessTime ; 
BlockMemoryRequest . ConpletionTimeEstimate-BlockTOA; 
ChangeTopMemoryRequest (SBlockBuffer, SBlockMemoryRequest) ; 

} 


} 
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**  Memory,  c  ** 

**  ** 

**  AddAWordToMemoryRequest  ** 

**  ** 

**  Description:  ** 


**  AddAWordToMemoryRequest  adds  a  word  to  a  MemoryRequest  as  if  it  ** 
**  had  been  read  in  from  memory.  The  address  is  first  aligned  to  ** 
**  WordSize.  This  simulates  the  data  being  added  to  the  request.  ** 
**  ** 


void  AddAWordToMemoryRequest  (MemoryRequest) 

MemoryRecjuestType  *MemoryRequest; 

MemoryRequest->Address»WordAddress (MemoryRequest->Address ) ; 
MemoryRequest->Si2e+“WordSize; 

} 


Memory . c 
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RemoveAWordFromMemoryRecjuest 


Description: 


RemoveAWordFromMemoryRequest  removes  a  word  from  a  Memory  Request, 
as  if  it  had  been  written  to  memory.  A  copy  of  the  Address  is  first 
stored  in  OldAddress.  Then  the  Address  is  word  aligned  and  incremented 
by  WordSize.  The  Required  Size,  and  Size  are  then  decremented  by  the 
difference  of  the  new  Address,  and  the  OldAddress.  Finally  if  the 
Address  is  outside  the  range  of  the  original  block  then  the  Address  is 
decremented  by  BlockSize  to  simulate  modulo  addition.  This  simulates 
removing  a  word  from  the  memory  request  taking  into  account  word  and 
block  alignment  constraints. 


void  RemoveAWordFromMemoryRequest (MemoryRequest ) 
MemoryRequestType  *MemoryRequest ; 


AddressType  01dAddress-MemoryRequest->Address; 

MemoryRequest->Address=WordAddress (MemoryRequest->Address )  +WordSize ; 

if  (MemoryRequest->Size>BlockSize-WordSize) 
MemoryRequest->Size=BlockSize-WordSize; 
else  if  (MemoryReque3t->Size>MemoryRequest->Address-01dAddress) 
MemoryRequest->Size— ■MemoryRequest->Address-01dAddress,' 
else 

MemoryRequest->Size«*0; 

if  (MemoryRequest->RequiredSize>BlockSize-WordSize) 
MemoryRequest->RequiredSize=BlockSize-WordSize; 
else  if  (MemoryRequest->RequiredSize>MemoryRequest->Address-01dAddress) 
MemoryRequest->RequiredSize-=MemoryRequest->Address-01dAddress; 
else 

MemoryRequest->RequiredSize=0; 

if  (BlockAddress (OldAddress) <BlockAddress (MemoryRequest->Address) ) 
MemoryReciuest->Address-=BlockSize; 


} 


/***************************************************************************** 
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►*  TimeEst.c  ** 

►  *  ** 

►*  Part  Of  SACS  1.0  ** 

►*  (StillAnother  Cache  Simulator)  ** 

►  *  ** 

**  Program  Modified:  3/17/94  ** 

**  File  Modified:  3/17/94  ** 

**  ** 

»*  Author:  William  G.  Smith  ** 

**  Address:  Electrical  Engineering  Department  ** 

**  Naval  Postgraduate  School  ** 

**  Monterey,  CA  93940  ** 

**  Copyright  1994,  William  G.  Smith  ** 

** 

**  Permission  to  use,  copy,  modify,  and  distribute  this  software  and  ** 

**  its  documentation  for  any  purpose  and  without  fee  is  hereby  granted  ** 

**  provided  that  the  above  copyright  notice  appears  in  all  copies.  No  ** 

**  modified  version  of  this  program  should  be  redistributed  without  the  ** 

**  authors  consent.  William  G.  Smith  makes  no  warranty  or  ** 

**  representation,  promise  of  guarantee,  either  expressed  or  implied,  ** 

**  with  respect  to  this  software's  ability  to  produce  valid  results.  ** 

**  This  program  is  provided  "as  is"  any  financial,  personal  or  property  ** 

**  damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the  ** 

**  user.  ** 


♦include  "Global. h" 


\ 

t 
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TimeEat.c  ** 

**■ 


1r* 
it  it 
** 
it* 


List  of  TimeEst.c  Function  Declarations 


**  Description: 

★  ★ 

**  This  is  a  list  of  function  declarations  within  the  file  scope 

**  of  TimeEst.c 

*  « 


*it 
ir* 
ir  * 
irit 
*1r 

*  * 


void  UpdateTimeToExecute () ; 
void  CalculateTimeEstimates () ; 


/*  Page  6-  3  */ 
/*  Page  6-  5  */ 


** 

it* 

It* 

it* 

** 
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*  *  De  s  cr ipt ion : 

** 

**  UpdateTimeToExecute  calculates  the  time  to  conplete  a  memory 

**  transfer  given  the  MemoryRequest .  The  Memory  Request  could  be  a  read 
**  or  write  request  in  a  buffer.  UpdateTimeToExecute  changes  the 
**  TimeToExecute  field  to  the  new  value.  TimeToexecute  is  calculated  by 
**  first  finding  the  niunber  of  WordsToBeTransfered.  If  the  MemoryRequest 
**  is  not  being  accessed  then  the  TimeToExecute  is  simply  the  AccessTime 
**  plus  the  TransferTime  times  one  less  then  WordsToBeWritten .  If  the 
**  MemoryRequest  is  in  progress  then  the  new  TimeToExecute  is  dependent 
**  on  TOA,  or  TOD  of  the  next  word.  MemoryWaitingFor  dictates  whether  to 
**  use  the  TOA,  or  TOD.  If  MemoryWaitingFor  is  equal  to  CacheUpdate  then 
**  the  request  has  not  actually  begun  transferring  data.  So  the 
**  TimeToExecute  can  be  calculated  as  if  the  read  recfuest  is  not  in 
**  progress. 


void  UpdateTimeToExecute (MemoryRequest) 
MemoryRequestType  ‘MemoryRequest; 


( 


SizeType  WordsToBeTransfered; 


if  (MemoryRequest->Size>0) 

( 

WordsToBeTransfered-WordAddress (MemoryRequest->Address 

+MemoryRequest->Size-l ) 

-WordAddress (MemoryRequest->Address) +WordSize; 

} 

else 

{ 

WordsToBeTransfered-0; 


) 


WordsToBeTransfered/=WordSize; 


if  (WordsToBeTransfered> (BlockSize/WordSize) ) 
WordsToBeTransfered-BlockSize/WordSize; 
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**  TimeEst.c  ** 


ir* 
*  * 


Updat eTimeToExecute 
continued 


if  (WordsToBeTransfered>0) 

if  (MemoryRequest->AccessInProgress-=No) 

MemoryRequest->TimeToExecute=MemoryAccessTime 

+MemoryTransferTiine* (WordsToBeTransfered-1) ; 

} 

else 

if  (MeinoryWaitingFor=<=MemoryWaitingForMeinoryReadAccess  |  I 
MemoryWaitingFor=“MemoryWaitingForMemoryReadTransfer) 

MeinoryRequest->TimeToExecute=TOA-Time+MemoryTransferTiine 

* (WordsToBeTransfered-1) ; 

} 

else  if  (MemoryWaitingFor=>'MemoryWaitingForMemoryWriteAccess  | | 
MemoryWaitingFor==MemoryWaitingForMemoryWriteTransfer) 

MemoryRequest->TimeToExecute=TOD-Time+MemoryTransferTiine 

* (WordsToBeTransfered-1) ; 


else  if  (MemoryWaitingFor=«MemoryWaitingForCacheUpdate) 

MemoryRequest->TimeToExecute“MeinoryAccessTime+MemoryTransferTiine 

* (WordsToBeTransfered-1) ; 


} 

else 

i 

printf ("Error  found  in  [UpdateTiroeToExecute]  MemoryRequest\n") ; 
printfC'with  access  in  progress  while  MemoryWaitingFor  not\n"); 
printf ("reading  or  writing."); 

Dis crepancyFound=ye5 ; 

} 


} 

} 

else 

( 

MeinoryRequest->TimeToExecute=0 ; 
} 

} 


** 

** 
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** 
♦  * 


**  Description:  ** 

**  ** 


** 

** 

** 

** 

** 

** 

** 

** 

** 

** 


CalculateTimeEstimates  updates  the  ConpletionTimeEstiinates  for 
each  request  in  both  the  read  and  write  buffers.  This  funtion  is 
called  when  ever  the  CacheModel  adds  to  the  read  or  write  buffers. 
CalculateTimeEstimates  must  be  called  every  time  new  data  is  entered 
into  the  buffers.  This  is  because  all  previous  estimates  did  not  take 
into  acco\int  the  new  data  requested.  This  is  because  all  previous 
estimates  did  not  take  into  account  the  new  data  requested. 
CalculateTimeEstimates  first  orders  all  entries  in  both  the  ReadBuffer, 
emd  the  WriteBuffer  by  priority.  Then  CalculateTimeEstimates  steps 
though  both  buffers  simultaneously.  Each  time  picking  the  request  that 
has  the  highest  priority,  and  adding  the  time  to  execute  to  the 
TimeEstimate .  The  TimeEstimate  becomes  that  recpiests 
ConpletionTimeEstimate .  This  process  is  repeated  until  all  requests 
have  a  new  ConpletionTimeEstimate.  TimeToExecute  for  cache  request  is 
updated  before  it  is  used  to  calculate  the  TimeEstimate. 


Irir 

** 

** 


*  * 


void  CalculateTimeEstimates 0 

BufferSizeType  Readlndex-O; 

BufferSizeType  Writelndex-0; 

TimeType  TimeEstimate*Time; 

TimeType  BlockTOAEstimate»BlockTOA; 


Order (&ReadBuf fer) ; 
Order (fiWriteBuf fer) ; 


^************«'««*******«********«*****«'******'*****************************'*»** 
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**  TimeEst.c  ** 

**  ** 

**  CalculateTimeEstimates  ** 

**  continued  ** 

**  ** 

*♦***************************************************************************/ 


while  (ReadIndex<ReadBuffer .Next  I  I  WriteIndex<WriteBuffer .Next) 


if  (ReadIndex<ReadBuffer .Next  &&  WriteIndex<WriteBuffer .Next) 

{ 

if  (ReadBuffer .MemoryRequest [  Readindex  ] .Priority  <= 

WriteBuffer .MemoryRequest [Writeindex] .Priority) 

1 

UpdateTimeToExecute  (&  (ReadBuffer .MemoryRequest  [Readindex] ) ) ; 

if  (TimeEstimate<BlockTOAEstimate)  TimeEstiinate=BloclcTOAEstiinate; 
TimeEstimate+=ReadBuffer  .MemoryRequest  [Readindex]  .TimeToExecute; 
ReadBuffer  .MemoryRequest  [Readindex]  .ConpletionTimeEstimate= 
TimeEstimate; 

BlockTOAEstimate**TimeEstimate+BufferCacheAccessTime; 

Readlndex++; 

} 

else 

{ 

UpdateTimeToExecute  (s  (WriteBuffer .MemoryRequest  [Writeindex] ) ) ; 

TimeEstiinate+=»WriteBuffer .MemoryRequest  [Writeindex]  .TimeToExecute; 
WriteBuffer  .MemoryRequest  [Writeindex]  .ConpletionTimeEstimate- 
TimeEstimate; 

Writelndex++; 

} 

} 

else  if  (ReadIndex<ReadBuffer .Next) 

{ 

UpdateTimeToExecute  (&  (ReadBuffer .MemoryRequest  [Readindex] ) )  ; 

if  (TimeEstimate<BlockTOAEstimate)  Ti  )5timate=BlockTOAEstimate; 
TimeEstimate+=*ReadBuffer  .MemoryRequest  iReadlndex]  .TimeToExecute; 
ReadBuffer. MemoryRequest  [Readindex)  .Coii5>letionTimeEstimate= 
TimeEstimate; 

BlockTOAEstimate=TimeEstimate+BufferCacheAccessTime; 

Readlndex++; 

) 

else  if  (WriteIndex<WriteBuffer .Next) 

[ 

UpdateTimeToExecute  (i  (WriteBuffer. MemoryRequest  [Writeindex] ) )  ; 

TimeEstimate+»WriteBuffer .MemoryRequest  [Writeindex]  .TimeToExecute; 
WriteBuffer  .MemoryRequest  [Writeindex]  .CoirpletionTimeEstimate= 
TimeEstimate; 

Writelndex++; 

} 


} 


} 


** 
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** 


** 

** 

** 

** 
♦  # 
«* 
♦  * 
** 
** 
** 
** 

** 

** 

H* 

** 

Hit 

Hit 

** 

Hit 


Part  Of  SACS  1.0  ■  ** 

(StillAnother  Cache  Simulator)  ** 

HH 

Program  Modified:  3/17/94  ♦* 

File  Modified:  3/17/94  ** 

** 

Author:  William  G.  Smith  ** 

Address:  Electrical  Engineering  Department  ** 

Naval  Postgraduate  School  ** 

Monterey,  CA  93940  ** 

HH 

Copyright  1994,  William  G.  Smith  ** 

** 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and  ** 

its  documentation  for  any  purpose  and  without  fee  is  hereby  granted  ** 
provided  that  the  above  copyright  notice  appears  in  all  copies.  No  ** 
modified  version  of  this  program  should  be  redistributed  without  the  ** 
authors  consent.  William  G.  Smith  makes  no  warranty  or  ** 

representation,  promise  of  guarantee,  either  expressed  or  implied,  ** 

with  respect  to  this  software's  ability  to  produce  valid  results.  ** 

This  program  is  provided  "as  is"  any  financial,  personal  or  property  ** 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the  ** 
user.  ** 

HH 
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kk 

kk 

kk 

kk 

k  k 

Description: 

kk 

k  k 

kk 

Get.c  contains  all  functions  that  relate 

getting  the 

next  CPU 

k  k 

k  k 

request.  GetNextRequest  is  the  only  procedure 

(  called  outside  of  this 

kk 

k  k 

file  scope.  It  determines  whether  to  take  input 

from  the 

keyboard  or 

k  k 

k  k 

aa  input  file.  It  also  checks  the  input  data 

to 

see  if  it 

.  makes  sense. 

k  k 

k  k 

Table  of  Contents 

k  k 

k  k 
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GetNextRequest {)  . 
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GetNextFileRequest 0  . 

. .  Page 
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k  k 

k  k 

GetNextKeyBoardRequest 0  . 

. .  Page 

7-  6 

k  k 

♦include  "Global. h” 


void  GetNextRequest ( ) ; 

void  GetNextFileRequest 0 ; 

void  GetNextKeyBoardRequest 0 ; 


/*  Page  7-  3  */ 
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/*  Page  7-  6  */ 
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GetNextRequest 


Description: 


GetNextRequest  gets  the  next  simulated  request  from  the  CPU  to 
cache  (ie  a  Read  or  Write  request) .  The  request  is  checked  to  make 
sure  it  makes  sense.  If  a  request  is  not  block  alined,  then 
GetNextRequest  will  split  the  request  up  and  return  portions  of  the 
request  until  all  portions  have  been  used,  as  if  the  user  had  made 
several  different  requests. 


void  GetNextRequest 0 
{ 

static  AddressType  NextRequestAddress; 
static  SizeType  NextRequestSize-0; 
static  RequestType  NextRequest; 
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*♦  Get.c  ** 
**  ** 

**  GetNextRequest  ** 
**  continued  ** 
**  ** 


if  (NextRequestSize>0) 

if  (NextRequestSize<'*BlockSize) 

{ 

Reque s t S i ze»NextReque 3 t S i ze ; 

NextRequestSize»0; 

} 

else 

RequestSize^BlockSize; 

NextRequestSize— BlockSize; 

} 

RequestAddress-BlockAddress (RequestAddress) +BlockSize; 
Request-NextRequest ; 

} 

else 

if  (KeyBoardIO) 

PauseForCommand ( ) ; 

GetNextKeyBoardRequest ( ) ; 

} 

else 

< 

GetNextFileRequest () ; 

} 

if  (BlockAddress (RequestAddress) != 

BlockAddress (RequestAddress+RequestSize-1) ) 

NextRequestSize-RequestSize; 

RequestSize- (BlockAddress (RequestAddress) +BlockSize) -RequestAddress; 
NextRequestSize-RequestSize; 

NextRequestAddress-BlockAddress  (RequestAddress)  +BlockSize; 
NextRequest-Request ; 

) 

) 

i f  (Request ! =None ) 

( 

LastRequest-Request; 

NumberOfAccesses [Request] ++; 

} 


) 


^«'*******«***********************«**************'***«’*'***1t'*******'**********««** 
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**  Get.c  ** 

**  ir-k 

*♦  GetNextFileRequest  ** 

**  ** 

**  Description:  ** 

**  ** 

**  GetNextFileRequest  reads  in  one  request,  without  doing  any  error  ** 

**  checking.  ** 

★  ★  ★* 

★★★★★★★★★♦★★♦★★★★♦★★★★★★***********************w* **★*★*★★★★★**★★★★*★★*★** ****y 


void  GetNextFileRequest 0 


char  RequestChar-'  ' , 

Chr; 

Request=None; 

if  (feof (DataFile) )  EndOfDataFile-Yes; 

while  (RequestChar'.-' r'  &&  RequestChar!-' w'  &&  RequestChar !='E'  && 
EndOfDataFile“No  &&  !  feof  (DataFile) ) 
fscanf (DataFile, "%c", ^RequestChar) ; 

if  (feof (DataFile)  II  RequestChar— ' E' )  EndOfDataFile-Yes; 

if  (EndOf DataFile— No) 

( 

fscanf (DataFile, "%1X",  ^Request Address) ; 
fscanf  (DataFile,  "%u",  SRecjuestSize) ; 
fscanf (DataFile,  "%U",  STimeOfNextRequest) ; 

if  (RequestChar—'  r' )  Request-Read; 
if  (RequestChar— '  w' )  Request-Write; 

TimeOfNextRequest+=Time; 

while  (RequestChar!-' \n'  &&  ! feof (DataFile) ) 
fscanf (DataFile, "%c", iRequestChar) ; 

) 

if  (feof (DataFile) )  EndOfDataFile-Yes; 


} 
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**  Get.c  ** 

**  •** 

**  GetNextBoardKey  ** 

**  •  ** 

**  Description:  ** 

**  ** 

**  GetNextFileRequest  reads  in  one  request,  without  doing  any  error  ** 

**  checking.  ** 

it*  *  * 


void  GetNextKeyBoardRequest ( ) 

char  chr; 

printf ("Please  enter  request  type  (r,w) .  "); 
while  (chr!='r'  &&  chr!='w'  &&  chr!='q') 

scanf("%c",  ichr) ; 

) 

if  (chr—'q')  exit(O); 

if  (chr«-'r')  Request-Read;  else  Recjuest-Write; 

printf ("Please  enter  Address  "); 

scanf ( " %U" ,  ^Request Address ) ; 

printf ("Please  enter  size  "); 

scanf ("%u",  SRequestSize) ; 

printf ("Time  until  next  request.  "); 

fflush(stdin) ; 

scanf ("%U",  STimeOfNextRequest) ; 
TimeOfNextRequest+=Time; 


} 
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*♦ 

** 

** 
♦  # 
it* 
It* 
** 
** 
** 
** 
** 
** 
■k* 
** 
** 
itir 
** 
** 
** 
** 


Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 
Address:  Electrical  Engineering  Department 
Naval  Postgraduate  School 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  doc\amentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  2Lbove  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  Willicun  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  iir^ilied, 
with  respect  to  this  software' s  ability  to  produce  valid  results . 

This  program  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user. 
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** 
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** 
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Display . c 

★  * 

♦  * 

*  1^ 

Description: 

itit 

it  it 

*  * 

Display. c  contains  all  display  functions 

used  within 

SACS. 

it  it 

♦  * 

Table  of  Contents 

itit 

it* 

ir* 
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it* 

List  of  Cache. c  Function  Declarations 

8-  2 

** 

it  it 

D i splayTrace ( )  . 

8-  3 

** 

*  * 

DisplayCurrentRequest ( )  . 

8-  4 

** 

*  * 

DisplayWaitingFors 0  . 

. Page 

8-  5 

** 

it  it 

DisplayBlock ( )  . 

8-  6 

** 

it  it 

DisplayBuffers 0  . 

. Page 

8-  7 

** 

it  it 

DisplayBuffer 0  . 

8-  8 

** 

** 

it  it 

DisplayRequestsBreakDown 0  . 

8-  9 

*  * 

it  it 

DisplayRequestHistogramO  . 

8-11 

** 

** 

it  it 

DisplayStallHistogramO  . 

. Page 

8-13 

** 

it  it 

LastScreenHistogramScore 0  . 

.  Page 

8-14 

*  * 

it  it 

DisplayCacheArguments 0  . 
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itit 

DisplayHelp 0  . 

8-17 

** 

** 

irit 

DisplayTestingHeader  0  . 

8-18 

** 

** 

** 

PrintTimeO  . 

8-20 

■f* 

** 

PrintTimeCenteredO  . 

8-20 

** 

** 

PrintScoreCenteredO  . 

8-20 

** 

PrintAddress 0  . 

. Page 
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** 

itit 

PrintCacheSize  ()  . 

8-20 

** 

«• 

PrintSizeO  . 

8-20 

** 

** 

PrintSize2()  . 

8-20 

*  * 

it  it 

PrintBufferSize 0  . 

8-21 

** 

*  k 

PrintPriority ()  . 

8-21 

** 

*  it 

PrintA jjociativity 0  . 

8-21 

** 

it  it 

PrintHistogramlndex ( )  . 

8-21 

*  * 

** 

it  it 

PrintBitO  . 

8-22 

*  * 

it  it 

PrintPercent  ()  . . . 

8-22 

** 

PrintAveAccess 0  . 

8-22 

** 

♦include  "Global. h 
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**  Display. c  ** 


** 

it* 


List  of  Display. c  Function  Declarations 


**  Description:  ** 

itir  It* 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "Display. c".  ** 

it*  It* 


void 

DisplayTrace () ; 

/* 

Page 

8-  3 

*/ 

void 

DisplayCurrentRequest () ; 

1* 

Page 

8-  4 

*/ 

void 

DisplayWaitingFors () ; 

/* 

Page 

8-  5 

*/ 

void 

DisplayBlock ( ) ; 

/* 

Page 

8-  6 

*/ 

void 

DisplayBuf fers () ; 

/* 

Page 

8-  7 

*/ 

void 

DisplayBuf fer 0 ; 

/* 

Page 

8-  8 

*/ 

void 

DisplayRequestsBreakDown () ; 

/* 

Page 

8-  9 

*/ 

void 

DisplayRequestHistogram( ) ; 

/* 

Page 

8-11 

*/ 

void 

DisplayStallHistogramO  ; 

/* 

Page 

8-13 

*/ 

ScoreType 

LastScreenHistogrcunScore  {) ; 

/* 

Page 

8-14 

*/ 

void 

DisplayCacheArguments () ; 

/* 

Page 

8-15 

*/ 

void 

DisplayHelp  0 ; 

/* 

Page 

8-17 

*/ 

void 

DisplayTestingHeader  0 ; 

/* 

Page 

8-18 

*/ 

void 

Print YesNo () ; 

/* 

Page 

8-19 

V 

void 

PrintRequest () ; 

/* 

Page 

8-19 

*/ 

void 

PrintReplacementPolicy  0 ; 

/* 

Page 

8-19 

*/ 

void 

PrintWritePolicy ()  ; 

/* 

Page 

8-19 

*/ 

void 

PrintWriteMissPolicy () ; 

/* 

Page 

8-19 

*/ 

void 

PrintWaitingFor 0  ; 

f* 

Page 

8-19 

*/ 

void 

PrintMemoryWaitingFor ( ) ; 

/* 

Page 

8-19 

*/ 

void 

PrintBlockWaitingFor () ; 

/* 

Page 

8-19 

*/ 

void 

Print Time () ; 

/* 

Page 

3-20 

*/ 

void 

PrintTimeCenteredO  ; 

/* 

Page 

8-20 

*/ 

void 

PrintScoreCenteredO  ; 

/* 

Page 

8-20 

*/ 

void 

PrintAddress () ; 

/* 

Page 

8-20 

*/ 

void 

Print CacheSize () ; 

/* 

Page 

8-20 

*/ 

void 

PrintSize  0 ; 

/* 

Page 

8-20 

*/ 

void 

PrintSize2 ()  ; 

/* 

Page 

8-20 

*/ 

void 

PrintBuf ferSize  0 ; 

/* 

Page 

8-21 

*/ 

void 

PrintPriority  0 ; 

/* 

Page 

8-21 

*/ 

void 

PrintAssociativity ()  ; 

/* 

Page 

8-21 

*/ 

void 

PrintHistogramIndex  0 ; 

/* 

Page 

8-21 

*/ 

void 

PrintBit () ; 

/♦ 
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V 

void 

PrintPercent () ; 

/* 
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8-22 

*/ 

void 

PrintAveAccess () ; 

/* 

Page 

8-22 

*/ 
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** 

it  it 
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it* 
*  * 


void  DisplayTrace () 

{ 

SizeType  BlockO=Set (Request Address) ‘Associativity; 

SizeType  Blockindex; 

SizeType  SubB lock Index ; 

system (ClearScreen)  ; 

DisplayCurrentRequest {) ; 

DisplayWaitingFors () ; 

printf ("\n") ; 

printfC  Set  Block  Address  "); 

for  (StibBlockIndex=0;  SubBlockIndex<NiainberOfSubBlocks;  SubBlockIndex++) 
printf ("  V/D  "); 
printf ("\n") ; 

for  (BlockIndex=BlockO;  BlockIndex<BlockO+Associativity;  BlockIndex++) 
DisplayBlock (Blockindex) ; 

printf ("\n"); 

DisplayBuffers ()  ; 

} 
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**  Display. c  ** 


**  DisplayCurrentRequest 


void  DisplayCurrentRequest 0 
{ 

if  (Request ! “None)  LastRequest=Request; 

if  (LastRequest“None) 

{ 

RequestAddress-0 ; 

Request Size-0; 

CacheHit“No; 

} 

if  (Request ! “None)  LastRequest=Request; 
if  (CacheWaitingFor! “Nothing) 

( 

printf ("\nCurrent  Request:  "); 

else 

{ 

printf ("\nLast  Request:  "); 

1 

PrintRequest (LastRequest) ; 

printf ("  Time:  "); 

Print Time (Time) ; 


printf ("\nAddress :  "); 

PrintAddress (RequestAddress) ; 

printf ("  Next  Rec[uest  Time:  "); 

PrintTime (TimeOfNextRequest ) ; 

printf ("XnSize:  "); 

PrintSize2 (RequestSize) ; 


if 


if 


(MemoryWaitingFor==MemoryWaitingForMemoryReadAccess  |  | 
Memory Wait ingFor==Memory Wait IngForMemoryReadTransfer) 

( 

print  f ( "  TOA :  " )  ; 

PrintTime (TOA) ; 

) 


(MemoryWaitingFor==MemoryWaitingForMemoryWriteAccess  I  I 
MemoryWaitingFor==MemoryWaitingForMemoryWriteTransfer) 


( 

printf (" 
PrintTime (TOD) ; 
} 


tt 


); 


printf ("\n") ; 
} 


TOD: 
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**  Display. c  ** 


DisplayWaitingFors 


*  it 


void  DisplayWaitingFors 0 

") ;  PrintWaitingFor (CacheWaitingFor) ; 

" ) ;  PrintMemoryWaitingFor (MemoryWaitingFor)  ; 

") ;  Print YesNo (CacheHit) ; 

" ) ;  PrintBlockWaitingFor (BlockWaitingFor) ; 

" ) ;  PrintYesNo (Buf ferHit) ; 

printf ("\n") ; 

} 


printf (  "Cache  Waiting  for: 

printf ("\nMemory  Waiting  For: 
printf ("  Cache  Hit: 

printf ("\nBlock  Waiting  For: 
printf ("  Buffer  Hit: 


** 
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** 

** 

** 

DisplayBlock 

ir* 

** 

** 

void  DisplayBlock (Blockindex) 

SizeType  Blockindex; 

SizeType  SubBlockIndex; 

if  (BlockIndex%AS3ociativity“*0) 

1 

PrintSize (Blockindex/Associativity) ; 

} 

else 

{ 

printf("  "); 

} 

printf("  "); 

PrintSize (Blockindex) ; 
printfC"  "); 

PrintAddress (CacheBlockAddress [Blockindex] ) ; 

for  (SubBlockIndex«0;  SubBlockIndex<Nmnber0fSul>Block5;  SubBlockIndex++) 
[ 

printf("  "); 

PrintBit (CacheValidBit [Blockindex] [SxibBlocklndex] ) ; 
printf("  "); 

PrintBit (CacheDirtyBit [Blockindex] [SubBlockIndex] ) ; 
printf("  "); 

} 

printf ("\n") ; 

} 


void  DisplayBuffers 0 
{ 

printf ("Read  Buffer  "); 
DisplayBuf fer (&ReadBuf fer) ; 

printf ("\n") ; 

printf ("Write  Buffer  "); 

DisplayBuffer (SWriteBuf fer) ; 

printf ("\n") ; 

printf ("Block  Buffer  "); 

DisplayBuffer (SBlockBuf fer)  ; 

} 
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**  Display. c  ** 
**  ** 


**  DlsplayBuffer  ** 

**  ** 


void  DlsplayBuffer (PrintBuffer) 
BufferType  *PrintBuffer; 


int  R; 

print f ("Address  Size  Req.  Block  Priority"); 

printf("  Time  Req.  Coirp.  Time\n"); 

for  (R“0;  R<PrintBuffer->Next;  R++) 

print  f ( "  " ) ; 

PrintAddress (PrintBuffer->MemoryReciuest [R] .Address) ; 
printfC  "); 

PrintSize2 (PrintBuf fer->MemoryRequest (R) .Size) ; 
printf("  "); 

PrintSize2 (PrintBuf fer->MemoryRequest IR) .RequiredSize) ; 
printf("  "); 

PrintSize (PrintBuf fer->MemoryRequest [R] .Block) / 
printf("  "); 

PrintPriority (PrintBuf fer->MemoryRequestfR] .Priority) ; 
printf("  "); 

PrintTimeCentered (PrintBuf fer->MemoryRequest [R] .TimeToExecute) ; 
printf("  "); 

PrintTimeCentered  (PrintBuf  fer->MemoryRequest  [R]  .CoirpletionTimeEstimate) ; 
printf ("\n"); 

} 


} 
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**  Display. c  ** 
**  ** 

**  DisplayRequestBreakDown  ** 
**  ** 


void  DisplayRequestsBreakDown 0 


ScoreType 

TotalN\unberOf Accesses  “NximberOf Accesses  (Read]  +N\ainberOf Accesses  [Write] , 
TotalNumberOfCacheHits-NujnberOfCacheHits  [Read]  +NuinberOfCacheHits  [Write] , 
TotalN\iroberOfBuf  ferHits-NumberOfBuf  ferHits  [Read]  +NuinberOfBuf  ferHits  [Write] ; 
system (ClearScreen) ; 


printf("\n  Requests  Break  DownVn"); 


printf("\n  "); 

printf (" 

Number 

Number 

Number 

printf("\n  "); 

printf ("Request 

of 

of 

of 

Hit 

printf ("\n  "); 

printf ("  Types 

Requests 

Cache  Hits 

Buffer  Hits 

Rates 

print f ("\n") ; 

printf("\n  Read  "); 

PrintScoreCentered(NumberOfAccesses [Read] ) ; 
printf("  "); 

PrintScoreCentered (NumberOfCacheHits [Read] ) ; 
printf("  "); 

PrintScoreCentered (NumberOfBuf ferHits [Read] ) ; 
if  (NiimberOf Accesses  [Read]  >0) 

[ 

printf("  "); 

PrintPercent (NumberOfCacheHits [Read] +NumberOfBuf ferHits [Read] , 
NumberOfAccesses [Read] ) ; 
printfC  "); 

PrintPercent ( (NumberOfAccesses [Read] -NumberOfCacheHits [Read] ) , 
NumberOfAccesses [Read] ) ; 


} 


Miss  ") 
Rates") 


printf("\n  Write  "); 

PrintScoreCentered (NumberOfAccesses [Write] ) ; 
printf("  "); 

PrintScoreCentered (NumberOfCacheHits [Write] ) ; 
printf("  "); 

PrintScoreCentered (NumberOfBuf ferHits [Write] ) ; 


if  (NumberOfAccesses [Write ]>0) 

{ 

printf("  "); 

PrintPercent (NumberOfCacheHits [Write 1+NumberOfBuf ferHits [Write] , 
NumberOfAccesses [Write] ) ; 
printf("  "); 

PrintPercent ( (NumberOfAccesses [Write] -NumberOfCacheHits [Write] ) , 
NumberOfAccesses [Write] ) ; 


) 


/****************************•************************************************* 
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**  Display. c  ** 
**  ** 

**  DisplayRequestBrealcDown  ** 
**  continued  ** 
**  ** 


printf("\n  Total  "); 

PrintScoreCentered (TotalKuinberOfAccesses) ; 
printf("  "); 

PrintScoreCentered (TotalNumberOfCacheHits)  ; 
printf("  "); 

PrintScoreCentered (TotalNvunberOfBufferHits) ; 


if 


{TotalNuinberOfAccesses>0) 

{ 

printf("  "); 

PrintPercent (TotalNumberOfCacheHits+TotalNumberOfBufferHits, 
TotalNumberOf Accesses) ; 
printf{"  "); 

PrintPercent (TotalNumberOf Accesses-TotalNiunberOfCacheHits 

-TotalNumberOf BufferHits, 
TotalNumberOf Accesses) ; 


} 


printf  <"\n”) ; 

DisplayRequestHistogramO  ; 


} 


*  it 
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*  it 

** 

** 

*  * 


void  DisplayRequestHistogramO 

SizeType  Time Index; 

printf("\n  Request  Time  Histogram"); 

printf("\n  "); 

for  (TimeIndex-'O;  Timelndex<ScreenHistogramMaxIndex;  Timelndex++) 
printf("  "); 

printf("  Ave  "); 

printf("\n  "); 

for  (TimeIndex-0;  TimeIndex<ScreenHistogramMaxIndex;  Timelndex++) 
printfC  "); 

printf("  Access"); 

printf("\n  "); 

for  (TimeIndex=0;  Timelndex<ScreenHistogramMaxlndex-l;  Timelndex++) 

print f ( "  Time-" ) ; 

PrintSize2 (Tiraeindex) ; 

} 

printf ("  Time>-") ; 

FrintSize2 (Timeindex) ; 
printf ("  Total  Time  "); 
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**  Display. c  ** 
**  ** 

**  DlsplayRequestHistogram  ** 
**  continued  ** 
**  ** 


printf("\n  Read  "); 

for  (Timelndex-O;  Timelndex< (ScreenHistogramMaxIndex-l) ;  Timelndex++) 
printf("  "); 

PrintScoreCentered(RequestTimeHi3tograin(Read] [Timeindex] )  ; 

} 

printf("  "); 

PrintScoreCenteredCLastScreenHistogramScore  (RequestTimeHistogramtRead] ) ) ; 
printf("  "); 

PrintScoreCentereddotalRequestTime  [Read] )  ; 
printf(" 

Print AveAccess (TotalRequestTime [Read] /NumberOfAccesses [Read] ) ; 
printf("\n  Write  "); 

for  (Timelndex-O;  Timelndex< (ScreenHistogramMaxIndex-1) ;  Timelndex++) 

( 

printf("  "); 

PrintScoreCentered(RequestTimeHistogram [Write] [Timeindex] ) ; 
printf("  "); 

PrintScoreCentered(LastScreenHistogramScore(Rec[uestTimeHistogram [Write] ) ) ; 
printf("  ”); 

PrintScoreCentered (TotalRequestTime [Write] ) ; 
printf("  "); 

PrintAveAccess (TotalRequestTime [Write] ,NumberOf Accesses [Write] ) ; 
printf ( " \n  Ideal  " ) ; 

for  (TimeIndex-0;  Timelndex< (ScreenHistogramMaxIndex-1) ;  Timelndex++) 

{ 

printf ("  "); 

PrintScoreCentered (RequestTimeHistogram [None] [Timeindex] ) ; 

} 

printf ("  "); 

PrintScoreCentered(LastScreenHistogramScore(RequestTimeHistogram[None] ) ) ; 
printf (”  ”); 

PrintScoreCentered (TotalRequestTime [None] ) ; 
printf ("\n") ; 


} 
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**  Display. c  ** 

**  ** 

**  Display Stallflistogram  ** 

★★ 


void  DisplayStallHistogramO 
i 

SizeType  Timelndex; 

CacheWaitingForType  Stallindex; 

system (ClearScreen) ; 

printf("\n\n  Stall  Time  Histogram\n\n")  ; 

printf("  "); 

for  (TimeIndex-0; TimeIndex<ScreenHistogramMaxIndex-l; Timelndex++) 

pr int  f ( "  Time= " ) ; 

PrintSize2 (Timelndex) ; 

} 

print f ( "  Time>*" ) ; 

PrintSize2 (Timelndex) ; 
printf("  TotalXn"); 
printf ("\n") ; 

for  (StallIndex-0; 

StallIndex<NiamberOfCacheWaitingForsAvailable; 

Stalllndex++) 

PrintWaitingFor (Stallindex) ; 

for  (TimeIndex=0;TimeIndex<ScreenHistogramMaxIndex-l;TimeIndex++) 
printf ("  "); 

PrintScoreCentered(StallTimeHistogram[StallIndex] [Timelndex] ) ; 

) 

printf ("  "); 

PrintScoreCentered(LastScreenHistogramScore(StallTimeHistogram[StallIndex] ) ) ; 
print  f  ( "  " ) ; 

PrintScoreCentered(TotalStallTime (Stallindex] )  ; 
printf ("\n") ; 

} 


} 


*  *  Display . c 

**  LastScreenHistogramScore 


ScoreType  LastScreenHistogramScore (Histogram) 
TimeType  ‘Histogram; 

( 

TimeType  Time Index; 

ScoreType  Sum»0; 

for  (Timelndex-ScreenHistogramMaxIndex-l; 
TimeIndex<FileHistogramMaxIndex; 
Timelndex++) 

Sum+-Histogreim[TimeIndex]  ; 


return (Sum) ; 


void  DisplayCacheArguments 0 
{ 

system (ClearScreen) ; 
printf ("\n") ; 

printf("  Cache  Arguments  List"); 

printf ("\n")  ; 

printf ("\nCache  Size:  ");  PrintCacheSize (CacheSize)  ; 

printf ("  "); 

printf ("Read  Forward:  ");  PrintYesNo (ReadForward) ; 

printf ("\nBlock  Size:  ");  PrintSize (BlockSize) ; 

printf ("  "); 

printf ("CPU  Waits  For  Cache  Writes:  ");  PrintYesNo (CPUWaitsForCacheWrites) ; 
printf ("\nSubBlock  Size:  ");  PrintSize (SubBlockSize)  ; 

printf ("  "); 

printf ("Search  Block  Buffer:  ");  PrintYesNo (SearchBlockBuf fer) ; 

printf ("\nAssociativity:  ");  PrintAssociativity (Associativity) ; 

printf ("  "); 

printf ("Update  Read  Buffer:  ");  PrintYesNo (UpdateReadBuf fer) ; 

printf ("\nWord  Size:  ");  PrintSize (WordSize) ; 

printf ("  "); 

printf ("Remove  Read  Duplicates:  ");  PrintYesNo (RemoveReadDuplicates) ; 

printf ("\nRead  Cache  Access  Time:  ");  PrintTime (ReadCacheAccessTime) ; 

printf  ("  "); 

printf ("Remove  Write  Duplicates:  ");  PrintYesNo (RemoveWriteDuplicates) ; 

printf ("\nRead  Cache  Hit  Time:  ");  PrintTime (ReadCacheHitTime) ; 

printf ("  "); 

printf ("Read  Priority :  ");  PrintPriority (ReadPriority) ; 

printf ("\nRead  Cache  Miss  Time:  ");  PrintTime (ReadCacheMissTime) ; 

printf ("  "); 

printf ("Write  Priority:  ");  PrintPriority (WritePriority) ; 

printf ("\nWrite  Cache  Access  Time:  ");  PrintTime (WriteCacheAccessTime) ; 

printf  ("  "); 

printf ("Read  For  Write  Allocate:  "); 

PrintPriority  (ReadForWriteAllocate’^riority) ; 
printf ("\nWrite  Cache  Hit  Time:  ");  PrintTime (WriteCacheHitTime) ; 

printf ("  "); 

printf ("Write  Dirty  Block  Priority:  "); 

PrintPriority (WriteDirtyPlo ckPriority) ; 
printf ("\nWrite  Cache  Miss  Time:  ");  PrintTime (WriteCacheMissTime) ; 

printf ("  "); 

printf ("No  Priority: 


) ;  PrintPriority (NoPriority) ; 
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1^  ii 
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printf ("\nMemory  Access  Time:  ");  PrintTime (MemoryAccessTime)  ; 

printf("  "); 

printf ("Trace :  ");  PrintYesNo (Trace) ; 

printf ("\nMemory  Transfer  Time:  ");  PrintTime (MemoryTransferTime) ; 

printf  ("  "); 

printf ("Check:  ");  PrintYesNo (Check) ; 

printf ("\nBuffer  Cache  Access  Time:  ");  PrintTime (BufferCacheAccessTime) ; 

printf ("  "); 

printf ("Test :  ");  PrintYesNo(Test); 

printf ("\nRead  Buffer  Size:  ");  PrintBuf ferSize (ReadBufferSize) ; 

printf ("  "); 

printf ("Key  Board  10:  ");  PrintYesNo (KeyBoardIO) ; 

printf ("\nWrite  Buffer  Size:  ");  PrintBuf ferSize (WriteBufferSize) ; 

printf ("  "); 

printf ("Data  File  Name:  %s",DataFileName) ; 

printf ("\nBlock  Replacement  Policy:  "); 

PrintReplacementPolicy (BlockReplacementPolicy) ; 
printf  ("  "); 

printf ("Screen  History  Max  Index:  "); 

PrintHistogramIndex (ScreenHistogramMaxIndex) ; 
printf ("\nWrite  Policy  ");  PrintWritePolicy (WritePolicy) ; 

printf ("  "); 

printf ("File  History  Max  Index:  "); 

PrintHistogramIndex (FileHistogramMaxIndex) ; 
printf ("\nWrite  Miss  Policy:  "); 

PrintWriteMissPolicy (WriteMissPolicy) ; 


printf ("\n") ; 
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**  Display. c  ** 

**  ** 

**  DisplayHelp  ** 

**  ** 


void  DisplayHelp () 


system(ClearScreen) ; 


printf("  Help  Menu  "); 

printf {"\n") ; 

printf("\n  [T]  Trace  Display:  "); 

printf {"\n  Displays  current  request,  status  of  memory,  and  contents  "); 

printf ("\n  of  buffers.  "); 

printf ("\n") ; 

printf ("\n  [R]  Results  Display:  "); 

printf ("\n  Displays  a  break  down  of  read  and  write  cache  hits,  and  "); 

printf ("\n  buffer  hits,  including  a  timing  analysis.  "); 

printf ("\n") ; 

printf ("\n  [S]  Stall  Timing  Display:  "); 

printf ("\n  Displays  a  histogram  of  the  time  spent  on  each  stall.  "); 

printf ("\n  Stalls  represent  time  delays  in  conpleting  a  request  "); 

printf ("\n") ; 

printf ("\n  [C]  Cache  Arguments  Display:  "); 

printf ("\n  Displays  input  arguments  to  SACS.  "); 

printf ("\n") ; 

printf ("\n  [G]  Go:  Go  to  end  of  run.  "); 

printf ("\n  [G  #]  Go  To:  Go  to  Time  #.  "); 

printf ("\n  [#]  Step:  Increment  Time  By  #.  "); 

printf ("\n  [-#]  Back  Step:  Decrement  Time  By  #.  "); 

printf ("\n  [H]  Help:  Displays  this  help  menu.  "); 

printf {"\n  "); 


) 


*  * 
** 

*  * 

«  * 

*  it 
*iHr 
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DisplayTestingHeader 


void  DisplayTestingHeader 0 
{ 

printf ("\n") ; 
system (ClearScreen)  ; 
printf ("\n\n")  ; 

printf ("\n\n  "); 

printf ("  Testing  SACS"); 

printf ("\n\n  "); 

printf ("Total  number  of  loads  and  stores  tested  %lu.", 
TotalNumberOf Accesses) ; 
printf ("\n\n  "); 

printf ("  Test  Cases  chosen  ...  ”); 

printf  ("\r.\n")  ; 

} 
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**  Print  Enumeration  Stings  ** 

*1^  ** 


void  Print YesNo (Value) 

YesNoType  Value; 

( 

printf ("%s", YesNoString [Value] ) ; 

} 

void  PrintRequest (Value) 

RequestType  Value; 

( 

printf ("%s".  Requeststring [Value] ) ; 

} 

void  PrintReplacementPolicy (Value) 
BlockReplacementPolicyType  Value ; 

{ 

printf ("%s",  ReplacementPolicyString [Value] ) ; 
} 

void  PrintWritePolicy (Value) 

WritePolicyType  Value; 

{ 

printf ("%s",  WritePolicyString [Value] ) ; 

} 

void  PrintWriteMissPolicy (Value) 
WriteMissPolicyType  Value; 

printf ("%s",  WriteMissPolicyString [Value] ) ; 

) 

void  PrintWaitingFor (Value) 

CacheWaitingForType  Value; 

printf ("%s", CacheWaitingForString [Value] ) ; 

] 

void  PrintMemoryWaitingFor (Value) 
MemoryWaitingForType  Value; 

{ 

printf ("%s",MemoryWaitingForString [Value] ) ; 

} 

void  PrintBlockWaitingFor (Value) 
BlockWaitingForType  Value; 

( 

printf ("%s",BlockWaitingForString [Value] ) ; 

} 
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void  PrintTime (Time) 
TimeType  Time; 

{ 


if 

(Time>-10000000) 

printf ("%81u 

else 

if 

(Time>“1000000 

) 

printf ("%71u 

else 

if 

(Time>“100000 

) 

printf ("%61u 

else 

if 

(Time>»10000 

) 

printf ("%51u 

else 

if 

(Time>»1000 

) 

printf ("%41u 

else 

if 

(Time>-100 

) 

printf ("%31u 

else 

if 

(Time>-10 

) 

printf ("%21u 

else 

printf ("%llu 

,  Time)  ; 
",Time) ; 

",  Time) ; 
",Time) ; 

”,  Time) ; 

" ,  Time ) ; 
",  Time) ; 
",Time) 


} 


void  PrintTimeCentered(Time) 

TimeType  Time; 

{ 

if  (Time>=1000000)  printf ("%81u", Time) ; 

else  if  (Time>=10000  )  printf ("%71u  ",Time); 

else  if  (Time>=100  )  printf ("%61u  ",Time); 

else  printf ("%51u  ",Time); 

} 

void  PrintScoreCentered (Score) 

ScoreType  Score; 

{ 

if  (Time>-1000000)  printf ("%81u", Score) ; 

else  if  (Time>“10000  )  printf ("%71u  ",  Score); 

else  if  (Time>=100  )  printf ("%61u  ",  Score); 

else  printf ("%51u  ",  Score); 

} 


void  PrintAddress (Address) 
AddressType  Address; 

{ 

printf ("%081X",  Address) ; 

) 

void  PrintCacheSize (CacheSize) 
CacheSizeType  CacheSize; 

{ 

printf ("%081u", CacheSize) ; 

} 

void  PrintSize (Size) 

SizeType  Size; 

( 

printf ("%05u".  Size) ; 

) 


void  PrintSize2 (Size) 
SizeType  Size; 

printf ("%02u", Size) ; 
} 


/***************************************************************************** 
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**  ** 

**  Print  Routines  ** 

**  continued  ** 


void  PrintBufferSize (BufferSize) 
BufferSizeType  BufferSize; 

{ 

printf ("%02u", BufferSize) ; 

} 

void  PrintPriority (Priority) 

PriorityType  Priority; 

{ 

printf ("%02u", Priority) ; 

} 

void  PrintAssociativity (Associativity) 
AssociativityType  Associativity; 

( 

printf ("%02u", Associativity) ; 

) 

void  PrintHistogramlndex  (Histogreimlndex) 
HistogramIndexType  Histogramindex; 

( 

printf ("%04u", Histogramindex) ; 

} 
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**  continued 


void  PrintBit (Bit) 

YesNoType  Bit; 

{ 

printf ("%01u",Bit) ; 

} 

void  PrintPercent (Ntunerator, Denominator) 

ScoreType  Numerator; 

ScoreType  Denominator; 

{ 

if  (Denominator>0) 

{ 

printf  ("%6.21f",  (100 . 0*N\amerator)  /Denominator) ; 
printf ("%") ; 

} 

else 

{ 

printf  ("  "); 

) 


void  PrintAveAccess (TotalTime, TotalNumberof  Accesses) 

TimeType  TotalTime; 

ScoreType  TotalNumberof Accesses; 

{ 

if  (TotalNumberof Accesses>0) 

printf ("%8 . 61f " , (1 . 0*TotalTime) /TotalNumberof Accesses) ; 
) 

else 

{ 

printf ("  "); 

} 
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*  * 

Record. c 

** 

*<* 

*  * 

** 

Description: 

*<* 

** 

** 

itit 

*  * 

Record. c  contains  all  functions  that  relate 

to  the  recording  of  ** 

** 

time  for  requests,  and  waiting  fors,  as  well  as  a  procedure 

for  saving  ** 

*  * 

the  data  in  a  file  using  a  format  that  Matlab(TM) 

could  read 

** 

*  ★ 

itic 

«  it 

Table  of  Contents 

it  it 

it* 

it  it 

** 

Cover  Page  . 

. .  Page  9- 

** 

List  of  Record. c  Function  Declarations  .. 

. .  Page  9- 

2  ** 

it* 

RecordRequest 0  . 

. .  Page  9- 

3  ** 

itit 

RecordStall 0  . 

. .  Page  9- 

5 

Itit 

RecordForMatladi  ( )  . 

. .  Page  9- 

7  ** 

*★ 

it* 

♦include  "Global. h" 
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**  Record. c  ** 

**  ** 

**  List  of  Record. c  Function  Declarations  ** 

**  ** 

**  Description:  ** 

**  ** 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "Record. c".  ** 

**  ** 


void 

RecordRequest ()  ; 

/* 

Page 

9-  3 

*/ 

void 

RecordStall  0  ; 

/* 

Page 

9-  5 

*/ 

void 

RecordForMatlab () ; 

/* 

Page 

9-  7 

*/ 

**  Page  9-  3  ** 
**  Record. c  ** 
**  ** 

**  Record  Request  ** 
★  *  ** 

**  Description:  ** 
**  ** 

**  RecordRequest  records  the  time  spent  on  a  particular  reqpaest  and  ** 
**  stores  the  result  in  RequestTimeHistogram.  ** 
**  ** 


void  RecordRequest (Req) 

RequestType  Req; 

I 

static  TimeType  LastTime=l; 

static  TimeType  Lastdt=0; 

static  RequestType  LastReq=NumberOfRequestsAvailable; 

TimeType  dt=Time-LastTime; 

if  (Req"NumberOfRequestsAvailaLble) 

{ 

LastTime-1; 

La3tdt*0; 

LastReq-Req; 

} 

else  if  <Req==LastReq) 

{ 

TotalRequestTime [LastReq] -*Lastdt; 

if  (Lastdt>FileHistograinMaxIndex-l)  Lastdt’=FileHistogramMaxIndex-l; 
RequestTimeHistogram [LastReq] [Lastdt] — ; 

} 

else  if  (LastReq! -NumberOfRequestsAvailable) 

{ 

LastTime=Time ; 
dt-0; 

NxunberOfCacheHits [LastReq] +=CacheHit; 

NumberOfBuf ferHits [LastReq] +=Buf ferHit; 

} 


LastReq-Req; 
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**  Record. c  ** 
*  *  *  * 

**  Record  Request  ** 
**  continued  ** 
**  ** 


if  (Req!  =NuinberOfRequestsAvailable) 

TotalRequestTime [Req] +=dt; 

Lastdt»dt; 

if  (dt>FileHistograinMaxIndex-l)  dt=FileHistograinMaxIndex-l; 
if  (Time>=LastTime) 

RequestTimeHistograin[Req]  [dt]++; 

} 

else 

] 

printf ("\n\nError  [RecordRequest]  caculated  a  time  less  than  0"); 
printf("\n\n  Time  =  ");  PrintTime(Time); 
printf ("\n\nLastTime  =  ");  PrintTime(LastTime); 
printf ("\n\n") ; 

DiscrepancyFound=Yes; 

} 

} 
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RecordStall 


Description: 


** 

** 

** 


*  * 

** 

**  RecordStall  records  the  time  spent  on  a  particular  waiting  for  and  ** 

'*  stores  the  result  in  StallTimeHistogram.  ** 

★  *  ★  ★ 

*****************************************************************************/ 


void  RecordStall (CurrentWaitingFor) 

CacheWait ingForType  CurrentWaitingFor ; 

static  TimeType  PastTinie=l; 

static  TimeType  Pastdt=0; 

static  CacheWaitingForType  PastWaitingFor=None; 

TimeType  dt=Time-PastTime; 

if  (CurrentWaitingFor—NumberOfCacheWaitingForsAvailable) 

PastTime=l; 

Pastdt=0; 

PastWaitingFor*CurrentWaitingFor; 

} 

else  if  (CurrentWaitingFor==»PastWaitingFor) 

{ 

TotalStallTime [PastWaitingFor] -=Pastdt; 

if  (Pastdt>FileHistogramMaxIndex-l)  Pastdt®FileHistogramMaxIndex-l; 
StallTimeHistogram [PastWaitingFor] [Pastdt J — ; 

else  if  (PastWaitingFor !=NvimberOfCacheWaitingForsAvailable) 

( 

PastTime=Time; 

dt-0; 


PastWaitingFor=CurrentWaitingFor; 


Da/TA  Q.  ^  ii  it 


it  * 

*  it 

*  * 
*  * 
*  * 
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*  * 
*  * 
itir 
Hr  ★ 
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if  (Current Wait ingFor !  =NiiitiberOfCacheWaitingForsAvailable) 

( 

TotalStallTime  [CurrentWaitingFor] +=dt; 

Pastdt”dt; 

if  (dt>Fi  eHistogramMaxIndex-l)  dt=FileHistogramMaxIndex-l; 
if  (Time>”PastTime) 

( 

StallTimeHistogram[CurrentWaitingFor] [dt] ++; 

} 

else 

( 

print f ("\n\nError  [RecordStall]  calculated  a  time  less  than  0"); 
printf("\n\n  Time  =  ");  PrintTime (Time) ; 
printf ("\n\nPastTime  =  ");  PrintTime (PastTime) ; 
printf ("\n\n") ; 

DiscrepancyFound=Yes; 

) 

} 


*  * 

■*  it 

itir  irir 

**  RecordForMatleQD  ** 


Record. c 


Page  9-  7  ** 

it  it 


it  it 

**  Description: 

★  * 

**  RecordForMatlab  saves  the  RequestTimeHistogram,  and 

**  StallTimeHistograms  in  a  format  that  Matlab(TM)  reconizes. 

■* 


irir 
irir 
*  * 
it* 
it  ir 
it  ir 


void  RecordForMatlab 0 


CacheWaitingForType  Stallindex; 

RequestType  Requestindex; 

int  Coluinn, 

NumberOfColumns=2; 

HistogramIndexType  Histogramindex; 

FILE  ‘MatlabOut; 

if  ( (MatlabOut=fopen ("timing. m", "w"))==NULL) 

( 

printf'  Xan  not  open  matlab  output  file."); 

} 

for  (Request lndex=0;  Request Index<NvimberOfRequestsAvailable;  Request Index++) 
( 

fprintf (MatlabOut, "%s= [", Requeststring [Requestindex] ) ; 

fprintf (MatlabOut, "  %081u", RequestTimeHistogram[KequestIndex] [0] ) ; 

Column=l; 

for  (HistogramIndex=l; 

HistogramIndex<FileHistogramMaxIndex; 

HistogramIndex++) 

{ 

Colvimn++; 

if  (Column>NumberOf Columns) 

( 

Column=l; 

fprintf (MatlabOut,  ",  \n  "); 

} 

else 

{ 

fprintf (MatlabOut, ",  ") ; 

) 

fprintf (MatlabOut, "  %081u", 

RequestTimeHistogram [Requestindex] [Histogramindex] ) ; 

} 

fprintf (MatlabOut, "] ; \n\n") ; 


} 
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**  Record. c  ** 
**  ** 

**  RecordForMatlab  ** 
**  Continued  ** 
★  ★  ♦  ♦ 


for  (StallIndex=0; StallIndex<NumberOfCacheWaitingForsAvailable; Stalllndex++) 
{ 

fprintf (MatlabOut, "%s= [ ", CacheWaitingForString [Stallindex] )  ; 
fprintf (MatlabOut, "  %081u", StallTimeHistograin[StallIndex] [0] ) ; 

Column=l; 

for  (HistograinIndex=l; 

HistogramIndex<FileHistograinMaxIndex; 

HistogramIndex++) 

{ 

Coluinn++; 

if  (Column>NuinberOf Columns) 

{ 

Column=l; 

fprintf (MatlabOut, " , \n  " ) ; 

} 

else 

{ 

fprintf (MatlabOut, ; 

} 

fprintf (MatlabOut, "  %081u", 

StallTimeHistogramfotallIndex] [Histogramindex] ) ; 

fprintf (MatlabOut, "] ; \n\n")  ; 


f close (MatlabOut) ; 


} 


* 


it  * 
itir 
*■* 
*  ★ 
ir* 
it  it 
*  * 
it  it 
•kit 
it  it 
it  it 
*  ♦ 
it* 
it* 
it* 
*  * 
** 
** 
** 
*  * 
** 
** 
*  * 
** 
** 
** 
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Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 
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*  * 
** 
** 
*  * 
** 
** 
** 
*  * 
** 
** 
*  * 
*  * 
*  * 
** 
** 
** 
*  * 
** 
k  * 
** 
** 
*  * 
*  * 
** 
** 


Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  above  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  William  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  implied, 
with  respect  to  this  software's  ability  to  produce  valid  results. 

This  program  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user. 


** 


*  * 
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<** 

*« 

Buffer. c 

*  * 

itir 

** 

*  * 

Description: 

** 

it  it 

*  * 

it* 

Buffer.c  contains  all  functions  that  relate 

to  the  management  of 

*  * 

it* 

the  Read,  Write,  and  Block  Buffers. 

*  * 

*  * 

Table  of  Contents 

*  * 

*  * 
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NoRequestsLeft 0  . 
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*  * 

♦include  "Global. h" 


Buffer ,c 
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List  of  Buffer. c  Function  Declarations 


Description: 


**  This  is  a  list  of  functions  declarations  within  the  file  scope  ** 
**  of  "Buffer. c".  ♦* 
**  ** 


void 

MemoryRequestType 

void 

void 

MemoryRequestType 

void 

void 

void 

YesNoType 

YesNoType 

void 

YesNoType 


Push  0  ; 

PopO  ; 

ChangeTopMemoryRequest () ; 
Append ( ) ; 

ViewO  ; 

Clear () ; 

Order ( ) ; 

Splice  0 ; 

Search ( ) ; 

UpdatingReadBuf fer ( ) ; 
RemoveZeroSizes () ; 
NoRequestsLeft  0 ; 


/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 
/*  Page 


10-  3  */ 
10-  4  */ 
10-  5  */ 
10-  6  */ 
10-  7  */ 
10-  8  */ 
10-  9  */ 
10-10  */ 
10-12  */ 
10-13  */ 
10-15  */ 
10-16  */ 


void  Push (Buffer,  MemoryRequest) 

BufferType  ‘Buffer; 
MemoryRequestType  ‘MemoryRequest; 


BufferSizeType  i; 

if  (Buffer->Full) 

( 

CacheWaitingFor=Buffer->WaitingForFlag; 

} 

else 

for  (i=Buffer->Next;  i>0;  i — ) 

Buffer->MemoryRequest [i]=Buffer->MemoryRequest [i-1] ; 
Buffer->Next++; 

Buf f er->MemoryRequest [0 ] = ‘MemoryRequest ; 
if  (Buffer->Next>Buffer->Max)  Buffer->Full=Yes; 

Buffer->Eitpty=No; 

if  (CacheWaitingFor==Buffer->WaitingForFlag)  CacheWaitingFor=Nothing; 
) 
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**  Buffer. c  ** 


**  Description: 


Pop  ** 

★  ★ 
* 

★  ★  ★★ 

**  Pop  removes  a  record  from  the  top  of  the  buffer,  and  returns  it  to  ** 
**  the  caller  of  the  function.  ** 

**  ** 


MemoryRequestType  Pop (Buffer) 
BufferType  ‘Buffer; 


MemoryRequestType  MemoryRequest; 

BufferSizeType  i; 

if  (Buf fer->Empty  I  I  Buf fer->Next==0) 
i 

printf("\n\n  Tryed  to  Pop  an  enpty  buffer! \n\n") ; 
exit  (1) ; 

} 

else 

{ 

MemoryRequest=Buffer->MemoryRequest [0] ; 
for  (i=“0;  i<Buf fer->Next;  i++) 

Buf fer->MemoryRequest [i] =Buffer->MemoryRequest [i+1] ; 
Buffer->Next — ; 

if  {Buffer->Next=“=0)  Buffer->Empty=Yes; 

Buf fer->Full=No; 

} 

return (MemoryRequest) ; 


} 
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**  Buffer. c  ** 

** 

♦*  ChangeTopKemoryRequest  ■  ** 

**  ** 

**  Description:  ** 

**  ** 

**  Push  adds  a  new  record  to  the  top  of  the  buffer.  ** 

**  ** 


void  ChangeTopMemoryRequest (Buffer,  MemoryRequest) 

BufferType  ‘Buffer; 

MemoryRequestType  ‘MemoryRequest; 

( 

if  (Buffer->Einpty==No  &&  Buf fer->Next>0) 

{ 

Buf  f  er->MemoryRequest  [  0  ]  ^-‘MemoryRequest ; 

} 

else 

{ 

printf("\n\n  Tryed  to  Pop  an  empty  buffer ! \n\n") ; 
exit  (1) ; 

} 


} 
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**  Buffer. c  ** 


Append 


**  Description:  ** 

★  *  ** 

**  Append  adds  a  new  record  to  the  bottom  of  the  buffer.  ** 


void  Append (Buffer,  MemoryRequest) 

BufferType  *Buffer; 

MemoryRequest Type  *MemoryRequest/ 

{ 

if  (Buffer->Full) 

{ 

CacheWaitingFor=Buf fer->WaitingForFlag; 

} 

else 

( 

Buf fer->MemoryRequest [Buf fer->Next ] =*MemoryRequest; 

Buf fer->Next++; 

if  (Buf fer->Next>Buf fer->Max)  Buffer->Full=Yes; 

Buffer->Empty»'No; 

if  (CacheWaitingFor==Buffer->WaitingForFlag)  CacheWaitingFor=Nothing; 

} 

} 


/********************»********•**■•****************•*♦***************♦********* 
**  Page  10-  ** 

**  Buffer. c  ** 

**  ** 

★  ♦  View  ** 

*  *  *  <♦ 


**  Description: 

*  « 

*  * 


*  * 
*  * 


View  returns  a  copy  of  the  top  record  in  the  buffer  without 
altering  the  buffer. 


*  * 
*  * 

it  * 
Hr  ■* 
★  it 


itiHtitiritiririr**itiriririr*itir**iriririritiriritititiririt'¥ir*ir**itititit1r1tir‘kit1r1tir‘ttit*itit*itirititititiritir-kiririririt1riri 


MemoryRequestType  View (Buffer) 

BufferType  ‘Buffer; 

{ 

MemoryRequestType  MemoryRequest ; 
if  (Buf fer->Empty) 

printf("\n\n  Tryed  to  View  an  enpty  buf fer ! 'nKn" ) ; 
exit  (1) ; 

} 

else 

i 

MemoryReque3t=Buffer->MemoryRequest [0] ; 

} 

return (MemoryRequest ) ; 

) 


•*  ■* 
*  * 
■*  * 
*  * 
*  * 
it  it 


Buf fer .c 
Clear 

Description: 

Clear  removes  all  entrees  in  the  buffer. 

kititiritiririrititliiriritititiririririritiriririririririiiritiriritiritiririritiritiriti 


Page  10-  8  ** 

it  ■* 


it  * 
it  it 
it  it 


it  it 


void  Clear (Buf fer) 

BufferType  ‘Buffer; 
{ 

Buf fer->Next=0; 
Buffer->Full=No; 

Buf fer->Empty=Yes; 

} 
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Buffer . c 


Order 


*  Description:  ** 

★  *★ 

*  Order  sorts  all  of  the  entries  in  the  buffer  by  priority  such  ** 

*  that  the  highest  priority  (lowest  priority  number)  is  at  the  top.  ** 

*  *  * 

*★♦***********♦***★*******★***★★*★*****************************★************/ 


oid  Order (Buffer) 


BufferType  *T^uffer; 


MemoryRequestType  TnpMemoryRequest; 

YesNoType  Change=Yes; 

Buf ferSizeType  i; 

while  ( !  (Buf  fer->Eitpty)  &&  Change) 

{ 

Change-No ; 

for  (i-Buf fer->Next-l;  i>0;  i — ) 

( 

if  (Buffer->MemoryRequest [i] .Priority< 
Buffer->MemoryRequest [i-1] .Priority) 

( 

TnpMemoryReq[uest=Buffer->MemoryRequest  (i] ; 
Buffer->MemoryRequest [i]-Buffer->MemoryRequest [i-1] ; 
Buf  f er->MemoryRequest  [  i-1  ]  -TmpMeinoryRequest ; 
Change=Yes; 


Buf fer . c 


Splice 
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Description: 

Splice  is  buffer  utility  that  takes  a  one  byte  memory  request  and 
enters  it  into  a  buffer  if  the  buffer  does  not  already  have  the  byte. 
Splice  will  first  searchthe  ReadBuffer  for  the  byte  if  it  can't  find  a 
request  in  the  buffer  that  contains  the  byte  then  it  will  search  for  a 
memory  request  that  has  data  from  the  same  block.  If  one  is  found 
then  the  request  is  modified  to  include  the  new  read  byte  request. 

If  no  suitable  request  can  be  found  then  Splice  will  add  a  one  byte 
memory  request  to  the  Buffer. 


void  Splice (Buf fe-  ,  Address, RequiredSize, Block, Priority) 


Buf ferType 
AddressType 
SizeType 
SizeType 


♦Buffer; 

Address; 

RequiredSize; 

Block; 


PriorityType  Priority; 


BufferSizeType 

YesNoType 

AddressType 

AddressType 

AddressType 

SizeType 


Bufferindex; 

FoundBy te=No ; 

FrontAddress; 

BackAddress; 

CurrentBlockAddress=BlockAddress (Address) ; 
NextSize; 


MemoryRequestType  MemoryRequest ; 

MemoryRequest .Address  =  Address; 

MemoryRequest . Size  =  1; 

MemoryRequest .RequiredSize  =  0; 

MemoryRequest .Block  =  Block; 

MemoryRequest .Priority  =  Priority; 

MemoryRequest .AccessInProgress  =  No; 

MemoryRequest .TimeToExecute  =  0; 

MemoryRequest . CompletionTimeEstimate  =  0; 

if  (RequiredSize>0)  MemoryRequest .RequiredSize-1; 
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** 

Buffer .c 

*  * 

irir 

kit 

<*<* 

Splice 

k  k 

** 

continued 

kk 

-kit 

. 

kk 

if  ( !  (Buf fer->Einpty) ) 

for  (BufferInclex=0;  BufferIndex<Buffer->Next;  Bufferlnciex++) 

if  (BlockAddress (Buf fer->MemoryRequest [Buf ferindex] .Address) == 
CurrentBloc)cAddress ) 

{ 

NextSi2e=l; 

FrontAddress“Buffer->MemoryRequest (Buf ferindex] .Address; 
BackAddress  =FrontAddress; 

while  (FoundByte— No  &&  NextSize<-BloclcSize  && 

NextSize<= (Buf fer->MemoryRequest (Buf ferindex] .Size+1) ) 

{ 

if  (Bac)cAddress“Address) 

{ 

if  (NextSize>Buffer->MemoryRequest [Bufferindex] .Size) 

Buf fer->MemoryRequest [Bufferindex] .Si2e=NextSize; 
if  (RequiredSize>0) 

Buf fer->MemoryRequest (Bufferindex] .RequiredSize=NextSize; 
if  (Buf fer->MeinoryRequest (Bufferindex] .Priority>Priority) 

Buf fer->MemoryRequest (Bufferindex] .Priority=Priority; 
FoundByte*Yes; 

} 

if  (FrontAddress— Address  && 

Buf fer->MemoryRequest  (Bufferindex]  . Access InProgress—No) 

{ 

Buffer->MemoryRequest (Bufferindex] .Size=NextSize; 
if  (RequiredSize>0) 

Buf fer->MemoryRequest (Bufferindex] .RequiredSize++; 
if  (Buf fer->MemoryRequest (Bufferindex] .Priority>Priority) 
Buffer->MemoryReq[uest (Bufferindex] .Priority=Priority; 
FoundByte-Yes ; 

} 

NextSize++; 

if  (NextSize>Buffer->MemoryRequest (Bufferindex] .Size) 
FrontAddress — ; 

BackAddress++; 

if  (Bloc)tAddress (FrontAddress) !»CurrentBlockAddre3S) 
FrontAddress+»BlockSize; 

if  (BlockAddress (BackAddress)  l-CurrentBlockAddress) 
BackAddress-=BlockSize; 

} 

if  (Buf fer->MemoryRequest (Bufferindex) .Size-=BlockSize  && 

Buf fer->MeinoryRequest (Bufferindex] .AccessInProgress=“No) 

( 

Buffer->MemoryRequest [Bufferindex) .Address=Request Address; 

Buf fer->MemoryReque3t [Bufferindex] .RequiredSize-RequestSize; 

) 

} 

} 

} 

if  (FoundByte--No)  Append  (Buffer,  iMeinoryRequest) ; 

} 


**  Description:  .  ** 

**  *ir 

**  Search  checks  a  Puffer  to  see  if  it  contains  a  byte  addressed  by  ** 

**  Address.  ** 


YesNoType  Search (Buffer, Address) 

BufferType  *Buffer; 

AddressType  Address; 

{ 

BufferSizeType  Bufferindex; 

AddressType  ByteAddress; 

AddressType  CurrentBlockAddress=BlockAddress (Address) ; 

SizeType  NoBytes; 

YesNoType  FoundByte=No; 

if  ( !  (Buffer->Einpty) ) 

for  (BufferIndex=0;  BufferIndex<Buffer->Next;  Buf ferlndex++) 

( 

if  (BlockAddress (Buf fer->MemoryRequest [Buf ferindex] .Address)" 
CurrentBlockAddress ) 

{ 

ByteAddress=Buf fer->MemoryRequest [Bufferindex] .Address; 
for  (NoBytes*0; 

NoBytes<Buffer->MeinoryRequest (Bufferindex] .Size; 
NoBytes++) 

[ 

if  (ByteAddress==Address)  FoundByte=Yes; 

ByteAddress++; 

if  (BlockAddress (ByteAddress) ! “CurrentBlockAddress) 
ByteAddress-=BlockSize; 

} 

} 

} 

) 

return (FoundByte) ; 


} 
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**  Buffer. c  ** 

**  ** 

**  UpdatingReadBuffer  ** 

**  ** 


**  Description: 

**  UpdatingReadBuffer  takes  a  byte  of  data  provided  by  a  CPU  write 

**  reqeust  and  checks  to  see  if  it  is  needed  in  the  read  buffer.  If  the 
**  byte  is  needed  then  the  MemoryRequest  is  modified  so  that  the  byte 
**  is  no  longer  in  the  request. 


★  ★ 

ir* 

** 

itit 


YesNoType  UpdatingReadBuffer (Address) 

AddressType  Address; 

{ 

AddressType  ByteAddress; 

AddressType  CurrentBlockAddress  =  BlockAddress (Address)  ; 

BufferSizeType  Bufferindex; 

YesNoType  FoundByte  -No; 


**  Page  10-14  ** 
**  Buffer.c  ** 
★  ♦  ★  ★ 

**  UpdatingReadBuffer  ** 
**  continued  ** 
*  *  *  * 


if  (! (ReadBuffer. Empty) ) 

for  (Buf ferlndex=0;  Buf ferIndex<ReadBuf fer .Next;  Bufferlndex++) 

{ 

if  (BlockAddress (ReadBuffer .MemoryRequest [Bufferindex] .Address) == 
CurrentBloc)cAddress 

&&  Read-  'fer .MemoryRequest [Bufferindex] .AccessInProgress==No) 

{ 

if  (ReadBuffer .MemoryRequest [Bufferindex] .Si2e>0) 

[ 

ByteAddress=ReadBuffer  .MemoryRequest  [Bufferindex]  .Address  + 

ReadBuffer .MemoryRequest [Buf ferindex] .Size  -  1; 

if  (ByteAddress“Addre3s) 

( 

ReadBuffer .MemoryRecjuest [Bufferindex] .Size — ; 
if  (ReadBuffer .MemoryRequest [Bufferindex] .RequiredSize> 
ReadBuffer .MemoryRequest [Bufferindex] .Size) 

ReadBuffer .MemoryRequest [Bufferindex] .RequiredSize= 
ReadBuffer .MemoryRequest [Bufferindex] .Size; 
FoundByte=Yes ; 

} 

} 

if  (ReadBuffer .MemoryRecjuest [Bufferindex] .Size>0) 

{ 

if  (ReadBuffer .MemoryRequest  [Bufferindex]  .Address»-Address) 

( 

ReadBuffer .MemoryRequest [Bufferindex] .Address++; 
if  (BlockAddress (ReadBuffer .MemoryRequest [Bufferindex] .Address) 
! “CurrentBlockAddress) 

ReadBuffer .MemoryRequest [Bufferindex] .Addres5-=BlockSize; 
if  (ReadBuffer. MemoryRequest [Bufferindex] .Size  >0) 

ReadBuffer .MemoryRequest [Bufferindex] .Size — ; 
if  (ReadBuffer .MemoryRequest [Buf ferindex] .RequiredSize>0) 
ReadBuffer  .MemoryRequest  [Bufferindex]  .RecfuiredSize — ; 
FoundByte=Yes  ; 

} 

} 

} 

) 

} 


RemoveZeroSizes (SReadBuffer) ; 
return (FoundByte) ; 


} 
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**  Buffer. c  ** 

**  ** 

**  RemoveZeroSizes  ** 

★  ★  ★★ 

**  Description: 

**  ** 

**  RemoveZeroSizes  removes  all  entrees  that  have  a  zero  size  from  ** 

**  the  buffer.  ** 

★  ★  ★★ 


void  RemoveZeroSizes (Buffer) 
BufferType  ‘Buffer; 


BufferSizeType  i=*0; 

BufferSizeType  j-0; 

while  ( j<Buffer->Next) 

{ 

if  (Buffer->MemoryRequest ( j] .Size==0  && 

i.Buf fer->MemoryRequest  ( j ]  .AccessInProgress) 

( 

j++; 

Buffer->Full*No; 

else 

Buf  f  er->MemoryRequest  ( i  ]  =Buf  f  er->MemoryRec[uest  t  j  ] ; 
i++; 

j++; 

} 

Buffer->Next-i; 

if  (Buffer->Next-— 0)  Buffer->En5>ty-Yes; 


} 
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**  Buffer. c  ** 

»*  ** 

**  NoRequestsLeft  ** 

**  ** 

**  Description:  ** 

**  ** 

**  NoRequestsLeft  returns  Yes  if  there  are  no  more  requests  left  ** 

**  in  the  buffer.  ** 

*  *  ★★ 


YesNoType  NoRequestsLeft (Buffer) 

BufferType  *Buffer; 

{ 

BufferSizeType  i; 

for  (i=0;  i<Buffer->Next;  i++) 

if  (Buffer->MemoryRequest [i] .RequiredSize>0)  return(No); 
} 

return (Yes) ; 

} 
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**  Array. c  ** 

★*  ** 

**  Part  Of  SACS  1.0  ** 

**  (StillAnother  Cache  Simulator)  ** 

**  ** 

**  Program  Modified:  3/17/94  ** 

**  File  Modified:  3/17/94  ** 

**  ** 

**  Author:  William  G.  Smith  ** 

**  Address:  Electrical  Engineering  Department  ** 

**  Naval  Postgraduate  School  ** 

**  Monterey,  CA  93940  ** 

**  *★ 

*'  Copyright  1994,  William  G.  Smith  ** 

**  ** 

**  Permission  to  use,  copy,  modify,  and  distribute  this  software  and  ** 

**  its  documentation  for  any  purpose  and  without  fee  is  hereby  granted  ** 

**  provided  that  the  above  copyright  notice  appears  in  all  copies.  No  ** 

**  modified  version  of  this  program  should  be  redistributed  without  the  ** 

**  authors  consent.  William  G.  Smith  makes  no  warranty  or  ** 

**  representation,  promise  of  guarantee,  either  expressed  or  implied,  ** 

**  with  respect  to  this  software's  ability  to  produce  valid  results.  ** 

**  This  program  is  provided  "as  is"  any  financial,  personal  or  property  ** 

**  damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the  ** 

**  user.  ♦* 

**  *  * 

********♦********♦******************★*********♦***♦***********♦**************/ 


/**********•********************************************************»********** 
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★  *  Array . c  *  * 

★  ★  kit 

**  Description:  ** 

★  ★  ** 

**  Array. c  contains  all  functions  that  relate  to  definition  and  ** 

**  freeing,  or  allocation,  and  deallocation  of  arrays.  ** 

**  ★* 

**  Table  of  Contents  ** 

★  ★  ★  ♦ 

**  Cover  Page  .  Page  11-1  ** 

**  List  of  Array. c  Function  Declarations  .  Page  11-2  ** 

**  DefineArraylD  ()  .  Page  11-3  ** 

**  DefineArray2D  0  . Page  11-  4  ** 

**  FreeArraylD  0  .  Page  11-5  ** 

**  FreeArray2D  0  .  Page  11-6  ** 
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*  *  Array . c  *  * 

**  ** 

**  List  of  Array. c  Function  Declarations  ** 

**  •  ** 

**  Description:  ** 

**  ** 

**  This  is  a  list  of  function  declarations  within  the  file  scope  ** 

**  of  "Array. c".  ** 


int  *Def ineArraylD ( ) ; 
int  *  *De  f ineArray2D  ( ) ; 
void  FreeArraylD ( ) ; 
void  FreeArray2D () ; 


/*  Page  11-  3  */ 
/*  Page  11-  4  */ 
/*  Page  11-  5  */ 
/*  Page  11-  6  */ 


**  Page  11-  3  ** 
**  Array. c  ** 
**  ** 


**  Description: 


DefineArraylD 


*  # 


* 

♦  ★ 


DefineArraylD  allocates  memory  large  enough  for  a  1  dimensional  ** 
**  array  of  length  Xmax,  where  each  element  has  "size"  bytes.  ** 


int  *DefineArraylD (Xmax,  size) 

unsigned  Xmax; 
unsigned  size; 

{ 

int  ‘Array; 

Array=(int*)  calloc (Xmax,  size) ; 
return (Array)  ; 

} 


int  **DefineArray2D (Xmax, Ymax, size) 

unsigned  Xmax; 
unsigned  Ymax; 
unsigned  size; 

int  **Array; 

unsigned  x; 

Array- ( int ** )  calloc (Xmax, size) ; 

for  (x-0;  x<Xmax;  x++)  Array [x] = (int*)  calloc (Ymax, size) ; 
return (Array) ; 

) 


*  * 
♦  * 

«  it 
*  * 
* 

*  * 
*  * 
*  * 
■*  it 


ritiiirititititl 
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Array . c 
FreeArraylD 

Description: 

FreeArraylD  deallocates  the  memory  assigned  to  the  1  dimensional 
array . 


♦  * 

*  * 
it* 
it  * 
it  it 
it  it 
it  it 
it  it 
★  ♦ 


void  FreeArraylD (Array, Xmax) 
int  * Array ; 

{ 

free (Array) ; 

} 


void  FreeArray2D (Array, Xmax, Ymax) 

int  ** Array; 

unsigned  Xmax; 
unsigned  Ymax; 

{ 

unsigned  x; 

for  (x-0;  x<Xmax;  x++)  free (Array [x] ) ; 
free (Array) ; 

) 


fit* 

'kit 
itit 
itit 
itit 
itit 
itit 
itit 
itit 
it  it 
itit 


** 
it  it 
it  it 

*  it 

*  * 
*  it 
irk 
kk 
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TestSACS.c 

Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 

Address:  Electrical  Engineering  Department 
Naval  Postgraduate  School 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  doc\imentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  eibove  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  Williauu  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  implied, 
with  respect  to  this  software's  ability  to  produce  valid  results. 

This  program  is  provided  "as  is"  any  financial,  person*  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user. 


♦  *  * 
*  k 
kk 
kk 
kk 
kk 
kk 
k  k 
kk 
kk 
kk 
k  k 
** 
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*« 

*  * 
■* 

*  # 
★  ★ 

#  it 
it  it 
it  it 

*  it 
it  it 
itit 
irit 
it* 
it  it 
it  it 
it  it 
*it 
it  it 
it  it 

♦  ♦ 
*  « 
itit 
it* 
** 
** 
** 
** 
** 
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TestSACS.c  ** 

Description: 


TestSACS  randomly  creates  instructions  and  writes  them  to 
"SACS.Dat".  The  instrcutions  are  generated  by  first  choosing 
NoTestCases.  The  Number  of  test  cases  to  be  used  will  always 
be  less  than  MaxNoTestCases .  Then  the  TestCaseChoosen  is  picked 
from  TestCases .  TestCases  represent  different  possible  ways  in 
which  an  address  trace  could  procede.  PredictedNoRead,  HitsInTest, 
and  PredictedNoWriteHitsInTest,  tells  TestSACS  how  many  hits  it  can 
expect  because,  it  used  a  specific  teat. 

Exanple : 
main  0 

unsigned  long  int  NoLoadHits; 
unsigned  long  int  NoLoadRequests; 

TestSACS (NumberOfRequests,  NumberOfHits) ; 

printf  ("\n\nN\amber  of  read  hitS“%ul",NoReadHits) ; 
printf ("\n\nNumber  of  read  requests-=%ul",NoReadRequests)  ; 
printf  ("\n\nNumber  of  write  hits**%ul",NoWriteHits); 
printf  ("\n\,iNumb2r  of  write  requests=%ul",NoWriteRequests) ; 


} 
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*  * 

CanBeSwitchedO  . 
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WritelnstructionSet 0  . 
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** 

*  * 


******  , 


#include<time .h> 


♦include  "Global. h 


z***************************************************************************** 

**  Page  12-  2  ** 

**  TestSACS.c  ** 

wit  *  * 

♦*  Description:  ** 

** 

**  List  of  definitions.  ** 

«*  it* 

iriflrititiHtitit*ir*iritiririritlr*itititit*lFiriHeieititirir*iririritiritit1t*****itiriiititiritititit*itiriritirititiririf^itiritit*itit^ 


♦define  MaxNoOfTestCases 


3  /*  Can  be  changed  without  other  changes.  */ 


♦define  NoTestCaseChoices  64  /*  //  Need  to  change  TestCases,  and  */ 

♦define  NoLoadStoresInTestCases  7  /*  \\  PredictedNoHitsInTest  */ 


♦define  IrandO  ((unsigned  long)  ( (randO  *0xl0001+rand() )  *0xl0001+rand() ) ) 


^«****************************«'*****'*'**'*****4lr*«*'****************************** 
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**  TestSACS.c  ** 

**  ** 

**  List  of  TestSACS.c  Function  Declarations  ** 


**  Description: 

**  This  is  a  list  of  functions  declarations  within  the  file  scope 

**  of  "TestSACS.c". 


** 
*  * 

Irir 


void 

ChangeArgiiments  () ; 

/* 

Page 

12-  6 

*/ 

void 

TestSACSO; 

/* 

Page 

12-  8 

*/ 

void 

CreatelnstructionSets  0 ; 

/* 

Page 

12-  9 

*/ 

void 

ShufflingInstructionSets () ; 

/* 

Page 

12-12 

*/ 

YesNoType 

CanBeSwitchedO  ; 

/* 

Page 

12-14 

*/ 

void 

WritelnstructionSet () ; 

/* 

Page 

12-15 

*/ 
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**  TestCases  ** 

★★  ★★ 

**  Description:  ** 

*★  ** 

**  Loading  Test  Cases,  the  each  number  is  an  indexe  for  an  array  of  ** 

**  BlockAddressChoices .  ** 

**  ** 

*********************************************************************♦*******/ 


int  TestCases [NoTestCaseChoices] [NoLoadStoresInTestCases]= 


{ 

1, 

1, 

1, 

1, 

1, 

1, 

1}, 

{ 

1, 

1, 

1, 

1, 

1, 

1, 

21, 

{ 

1, 

1, 

1, 

1, 

1, 

2, 

1}, 

{ 

1, 

1, 

1, 

1, 

1, 

2, 

21, 

{ 

1, 

1, 

1, 

1, 

2, 

1, 

1}, 

{ 

1, 

1, 

1, 

1, 

2, 

1, 

21, 

{ 

1, 

1, 

1, 

1, 

2, 

2, 

1}, 

{ 

1, 

1, 

1, 

1, 

2, 

2, 

21, 

1, 

1, 

1, 

2, 

1, 

1, 

1}, 

{ 

1, 

1, 

1, 

2, 

1, 

1, 

21, 

{ 

1, 

1, 

1, 

2, 

1, 

2, 

1}, 

{ 

1, 

1, 

1, 

2, 

1, 

2, 

21, 

i 

1, 

1, 

1, 

2, 

2, 

1. 

1}, 

{ 

1, 

1, 

1, 

2, 

2, 

1, 

21. 

{ 

1, 

1, 

1, 

2, 

2, 

2, 

11, 

{ 

1, 

1, 

1, 

2, 

2, 

2, 

21, 

{ 

1, 

1, 

2, 

1, 

1, 

1, 

11, 

{ 

1, 

1, 

2, 

1, 

1, 

1, 

2), 

{ 

1, 

1, 

2, 

1, 

1, 

2, 

11, 

{ 

1, 

1, 

2, 

1, 

1, 

2, 

21, 

{ 

1, 

1, 

2, 

1, 

2, 

1, 

11, 

{ 

1, 

1, 

2, 

1, 

2, 

1, 

21, 

{ 

1, 

1, 

2, 

1, 

2, 

2, 

11, 

1, 

1, 

2, 

1, 

2, 

2, 

21, 

1, 

1, 

2, 

2, 

1, 

1, 

11, 

{ 

1, 

1, 

2, 

2, 

1, 

1, 

21, 

{ 

1, 

1, 

2, 

2, 

1, 

2, 

11, 

{ 

1, 

1, 

2, 

2, 

1, 

2, 

21, 

{ 

1, 

1, 

2, 

2, 

2, 

1, 

11, 

{ 

1, 

1, 

2, 

2, 

2, 

1, 

21, 

{ 

1, 

1, 

2, 

2, 

2, 

2, 

11, 

{ 

1, 

1, 

2, 

2, 

2, 

2, 

21, 

{ 

1, 

2, 

1, 

1, 

1, 

1, 

11, 

{ 

1, 

2, 

1, 

1, 

1, 

1, 

21, 

{ 

1, 

2, 

1, 

1, 

1, 

2, 

11, 

{ 

1, 

2, 

1, 

1, 

1, 

2, 

21, 

{ 

1, 

2, 

1, 

1, 

2, 

1, 

11, 

{ 

1, 

2, 

1, 

1, 

2, 

1, 

21, 

{ 

1, 

2, 

1, 

1, 

2, 

2, 

11, 

1, 

2, 

1, 

1, 

2, 

2, 

21, 

{ 

1, 

2, 

1, 

2, 

1, 

1, 

11, 

{ 

1, 

2, 

1, 

2, 

1, 

1, 

21, 

{ 

1, 

2, 

1, 

2, 

1, 

2, 

11, 

{ 

1, 

2, 

1, 

2, 

1, 

2, 

21, 

{ 

1, 

2, 

1, 

2, 

2, 

1, 

11, 

( 

1, 

2, 

1, 

2, 

2, 

1, 

21, 

{ 

1, 

2, 

1, 

2, 

2, 

2, 

11, 

{ 

1, 

2, 

1, 

2, 

2, 

2, 

21, 

{ 

1, 

2, 

2, 

1, 

1, 

1, 

11, 

{ 

1, 

2, 

2, 

1, 

1, 

1, 

21, 

{ 

1, 

2, 

2, 

1, 

1, 

2, 

11, 

{ 

1, 

2, 

2, 

1, 

1, 

2, 

21, 

{ 

1, 

2, 

2, 

1, 

2, 

1, 

11, 

{ 

1, 

2, 

2, 

1, 

2, 

1, 

21, 

{ 

1, 

2, 

2, 

1, 

2, 

2, 

11, 

{ 

1, 

2, 

2, 

1, 

2, 

2, 

21, 

{ 

1, 

2, 

2, 

2, 

1, 

1, 

11, 

{ 

1, 

2, 

2, 

2, 

1, 

1, 

21, 

{ 

1, 

2, 

2, 

2, 

1, 

2, 

11, 

{ 

1, 

2, 

2, 

2, 

1, 

2, 

21, 

{ 

1, 

2, 

2, 

2, 

2, 

1, 

11, 

{ 

1, 

2, 

2, 

2, 

2, 

1, 

21, 

1, 

2, 

2, 

2, 

2, 

2, 

11, 

{ 

1, 

2, 

2, 

2, 

2, 

2, 

2} 

}; 


*  * 


Test SACS. c 
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♦  * 


**  PredictedNoReadHits,  and  PredictedNoWriteHits 

*it 

**  Description: 

**  No  Hits  Predicted  for  each  test  case. 

it  it 


it* 
it* 
irit 
Hit 
** 
•k* 
irk 
k  k 


int  PredictedNoReadHits InTest [NoTestCaseChoices] = 

6,  5,  5,  4, 

5,  4,  4,  3, 

5,  4,  4,  3, 

4,  3,  3,  2, 

5,  4,  4,  3, 

4,  3,  3,  2, 

4,  3,  3,  2, 

3,  2,  2,  1, 

5,  4,  4,  3, 

4,  3,  3,  2, 

4/  3^  3»  2/ 

3,  2,  2,  1, 

4,  3,  3,  2, 

3,  2,  2,  1, 

3,  2,  2,  1, 

2,  1,  1,  0 

1; 


int  PredictedNoWriteHitsinTest [NoTestCaseChoices]" 
[ 

Or  0/  0,  If 

0,  1,  1,  2, 

0,  1,  1,  2, 

1,  2.  2,  3, 

0,  1,  1,  2, 

1,  2,  2,  3, 

If  2;  2f  3r 

2,  3,  3,  4, 

0,  1,  1,  2, 

1/  2f  2r  3r 

If  2f  2^  3f 

2,  3,  3,  4, 

If  2/  2/  3f 
2,  3,  3,  4, 

2,  3,  3,  4, 

3,  4,  4,  5 

); 
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**  TestSACS.c  ** 


ChangeArgxunents 


**  Description: 


**  ChangeArguments,  change  the  global  variables  in  SACS  that  the 

♦*  user  can  change.  ** 

**  *1 

*****************************************************************************^ 
void  ChangeArguments () 


SizeType 

SizeType 

SizeType 

SizeType 

AssociativityType 

BufferSizeType 

TimeType 

WordSize 

SiibBlockSize 

BlockSize 


Associativity 

CacheSize 


ReadCacheAccessTime 

ReadCacheHitTime 

ReadCacheMissTime 

WriteCacheAccessTime 

WriteCacheHitTime 

WriteCacheMissTime 

MemoryAccessTime 

MemoryTrans  f  erTime 

BufferCacheAccessTime 

ReadBufferSize 

writeBufferSize 

BlockReplacementPolicy 

WritePolicy 

WriteMissPolicy 

ReadForward 

CPUWaitsForCacheWrites 

SearchBlockBuffer 

UpdateReadBu f f er 

Remove ReadDup 1 i cat e s 

RemoveWriteDuplicates 

ReadPriority 

WritePriority 

ReadForWriteAllocatePriority 

WriteDirtyBlockPriority 


WordSizeLimit 

Words?  er SubBl o ck 

NumberOfSubBlocksLimit 

NufflberOfBlocksLimit 

AssociativityLimit 

BufferSizeLimit 

TimeLimit 


(randO %  (WordSizeLimit-1) )  +1; 

WordSize*  ( (randO  %WordsPerSubBlock)  +1) ; 
SubBlockSize 

*  ( (randO  %NimnberOfSubBlocksLimit)  +1) ; 

( rand ( ) %Associat ivity Limit ) +2  ; 
BlockSize*Associativity* 

( (randO  %NumberOfBlocksLimit)  +1) ; 


rand ( ) 
rand ( ) 
randO 
rand  ( ) 
rand ( ) 
rand ( ) 
rand ( ) 
rand ( ) 
randO 


%  TimeLimit; 
%TimeLimit/ 
%TimeLimit; 
%TimeLimit; 
%TimeLimit; 
%TimeLimit; 
%TimeLimit ; 
%TimeLimit; 
%TimeLimit; 


(randO  IBufferSizeLimit)  +1; 

(rand ( ) %Buf f erSizeLimit ) +1 ; 

rand ( ) %NumberOfReplacementPoliciesAvailable; 

rand  0  %NumberOfWritePoliciesAvailable; 

rand ( ) %NumberOf Wr it  eMi  s  sP  o 1 i cies Avai lable ; 

rand ( ) %Unknown; 

rand ( ) %Unknown; 

rand ( ) % Unknown ; 

rand ( ) %Unknown; 

rand ( ) %Unknown; 

rand ( ) %Unknown; 


(randO  %  (NoPriority-1) )  +1 
(randO  %  (NoPriority-1) )  +1 
(randO %  (NoPriority-1) )  +1 
(rand  O  t (NoPriority-1) ) +1 


/*★**************************************************************♦************ 
•*  Page  12-  7  ** 

**  TestSACS.c  ** 

**  ** 

**  ChangeArguments  ** 

**  continued  ** 


**  Description: 

«  * 

Ensuring  that  the  new  argviments  are  valid  combinations. 


•k  * 
** 
kk 


if  (SearchBloclcBuffer=»No)  RemoveReadDuplicates=No; 
if  (UpdateReadBuffer  ==Yes)  WordSize-SubBlockSize; 

} 


TestSACS . c 
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**  TestSACS 

** 

**  Description: 

-*  * 

**  TestSACS  will  create  a  test  set,  shuffle  the  instructions,  and 

**  write  them  out  to  "SACS.Dat". 

*  * 


void  TestSACS  (NumberOfRequests,  NximberOfHits) 

ScoreType  *NumberOfRequests; 

ScoreType  *NumberOfHits; 

{ 

char  Request  tMaxNoOfTestCases*NoTestCaseChoices+l]  ; 

AddressType  DateiAddress  [MaxNoOfTestCases*NoTestCaseChoices+l] ; 

SizeType  Size  [MaxNoOfTestCase3*NoTestCaseChoices+l]  ; 

TimeType  TimeUntilNextRequest [MaxNoOfTestCases*NoTestCaseChoices+l]  ; 
int  Imax-0 ; 

DisplayTestingHeader 0  ; 

CreatelnstructionSets (Request,  DataAddress,  Size,  TimeUntilNextRequest, 

&Imax, 

NumberOfRequests,  NumberOfHits) ; 

Shuf flingInstructionSets (Request,  DateUVddress,  Size,  TimeUntilNextRequest 

Iroax) ; 

rewind (DataFile) ; 

WritelnstructionSet (Request,  DataAddress,  Size,  TimeUntilNextRequest, 

Imax) ; 

rewind (DataFile) ; 

EndOfDataFile-No; 
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** 

it  it 
it  it 
it  it 
it* 
*  * 
*  * 
*  * 
*  * 
*  * 
*  * 
** 
*  * 
*  * 
** 


Test SACS. c 

;reateIn?tructionSets 


Description: 


The 


The  instructions  are  created  from  a  set  of  test  cases, 
the  number  of  predicted  hits  for  each  case  is  stored  in 
PredictedNoHitsInTest .  CreatelnstructionsSets  randomly  chooses  the 
NoOfTestCases  to  be  used,  and  randomly  selects  the  individual 
TestCases.  The  BlockAddressChoices  for  each  test  case  is  also  chosen 
randomly.  The  DataAddress,  and  Size  of  each  instuction  is  chosen 
randomly  such  that  they  are  within  the  block  chosen.  The  NoLoadHits 
is  predicted  by  siamming  up  all  of  the  PredictedNoHitsInTest. 


** 
*  * 
** 
*  * 
*  * 
*  * 
** 
*  * 
*  * 
*  * 
** 
** 


void  CreatelnstructionSets (Request, 

DatciAddress, 

Size, 

TimeUntilNextRequest, 

Imax, 

NumberOf Requests, 
NumberOfHits) 


char 

AddressType 

SizeType 

TimeType 

int 

ScoreType 

ScoreType 


♦Request; 

♦DataAddress; 

♦Size; 

♦TimeUntilNextRequest; 

♦Imax; 

♦Numbe  rO  f Reque  s  t  s ; 
♦NumberOfHits; 


TimeType  MaxTimeUntilNextRequest  =  101; 

AddressType  BlockAddressChoices [NximberOfRequestsAvailable]  ; 
SizeType  SetChosen; 

int  TestCaseindex; 
int  Loadindex; 
int  NoOfTestCases; 
int  TestCaseChosen; 
int  i,  j,k; 


time_t  t; 

/♦  srand( (unsigned)  time(&t));  ♦/  /♦ 

/♦ 

/♦ 

/♦ 

/♦ 


Uncomment  to  randomize  each  test  run  ♦/ 


otherwise  every  test  run  will  be  ♦/ 
identical.  Leaving  the  seed  ♦/ 
commented  out  allows  any  errors  ♦/ 
found  by  -test  to  be  revisited.  ♦/ 


N\imberOfRec[uests  [Read  ]  =0 
NumberOfRequests (Write ] -0 
NumberOfHits  [Read  ]=0 
N\jmberOfHits  [Write]  =0 


TestSACS.c 
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*  * 


*  * 

CreatedlnstrutionSets  ** 

Continued  ** 

*  * 

Description:  ** 

Irit 

Creating  one  instruction  at  a  time.  ** 


* Imax-O ; 

NoOf Test Cases“rand ( ) %MaxNoOf TestCases+1 ; 

for  (TestCaselndex-0;  TestCaselndex<NoOfTestCases;  TestCaselndex++) 

{ 

TestCaseChosen=rand  0  %NoTestCaseChoices; 

SetChosen-rand  ( )  %NuinberOf  Sets ; 

BlockAddressChoices [Read] = 

(  {  (IrandO  /  (NoOfTestCases*NuinberOfSets*BlockSize) ) 
*NoOfTestCases+TestCaselndex) 

♦NumberOfSets  +  SetChosen)  *  BlockSize; 

BlockAddressChoices [Write ]=BlockAddressChoices [Read] ; 
if  (rand()%2) 

BlockAddressChoices [Write]* 

(  (  (IrandO  /  (NoOfTe3tCases*NviinberOfSets*BloclcSize) ) 
*NoOfTestCases+TestCaselndex) 

♦NvunberOfSets  +  SetChosen)  *  BlockSize; 

if  (BlockAddress (BlockAddressChoices [Read] ) 1 -BlockAddressChoices [Read] ) 
printf("Read  is  not  a  BlockAddress"); 
if  (BlockAddress (BlockAddressChoices [Write] ) ! -BlockAddressChoices [Write] ) 
printf ("Write  is  not  a  BlockAddress"); 

if  (Set (BlockAddressChoices [Read] ) ! -SetChosen) 
printf ("Read  is  not  a  good  Set"); 

if  (Set (BlockAddressChoices [Write] ) ! -SetChosen) 
printf ("Write  is  not  a  good  Set"); 

if  (BlockAddressChoices [Read] —BlockAddressChoices [Write ] ) 
printf ("%4dE", TestCaseChosen) ; 
else 

printf ("%4dN", TestCaseChosen) ; 
if  (TestCaseIndex%15— 14)  printf  ("\n") ; 
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**  TestSACS.c  ** 
**  ** 

**  CreatedInstrutionSets  ** 
**  Continued  ** 
**  ★★ 


if  (BlockAddressChoices [Read] ==BlockAddressChoices [Write ] ) 

] 

NumberOfHits [Read]  +“PredictedNoReadHitsInTest [TestCaseChosen]  ; 
NxomberOfHits [Write] +*PredictedNoWriteHitsInTe3t [TestCaseChosen] ; 

LoadIndex=0 ; 

while  (TestCases [TestCaseChosen] [LoadIndex]==Write  && 
WriteMissPolicy ! =WriteAllocate  && 

LoadIndex<NoLoadStoresInTestCases) 

[ 

NumberOfHits [Write] — ; 

LoadIndex++; 

} 

if  (TestCases [TestCaseChosen] [01==Read  &&  TestCaseChosen ! =0) 
NumberOfHits [Write] ++; 
if  (TestCases [TestCaseChosen] [0] “-Write  && 
WriteMissPolicy—WriteAllocate) 

NumberOfHits [Read] ++; 

} 

else 

NumberOfHits [Read]  +-PredictedNoReadHitsInTest [TestCaseChosen]  ; 
if  (WriteMissPolicy—WriteAllocate) 

NumberOfHits [Write] +-PredictedNoWriteHitsInTest [TestCaseChosen] ; 


for  (LoadIndex-0;  LoadIndex<NoLoadStoresInTestCases;  LoadIndex++) 
[ 

if  (TestCases [TestCaseChosen] [Loadindex]— Read) 

[ 

Request [ * Imax ] ='  r ' ; 

NiomberOf Requests  [Read]  ++; 

} 

else 

[ 

Request [*Imax]='w' ; 

NumberOf Requests [Write] ++; 

} 

DataAddress [ * Imax ]  = 

BlockAddressChoices [TestCases [TestCaseChosen] [Loadindex] ]  ; 

Size  [* Imax]  -IrandO  %BlockSize+l; 
if  (Size [ *Imax] <BlockSize) 

DataAddress [* Imax]  +=  IrandO % (BlockSize-Size[ * Imax] )+l; 
TimeUntilNextRequest [* Imax] -IrandO  %MaxTimeUntilNextRequest; 

(♦Imax) ++; 

} 


} 


♦  * 


Test SACS. c 


**  ShufflingInstructionSets 

**  Description: 

«  * 

**  Shuffling  Instruction  Sets. 

•*  ■* 


void  ShufflingInstructionSets (Request, 

DataAddress, 

Size, 

TimeUnt ilNextRequest , 
Imax) 


char 

AddressType 

SizeType 

TimeType 

int 


♦Request; 

♦DataAddress; 

♦Size; 

♦TimeUntilNextRequest; 

Imax; 


int 

char 

AddressType 
SizeType 
TimeType 
int  i,j,k; 


Junp; 

RequestTenp; 

AddressTeir^; 

SizeTemp; 

TimeTemp; 


k  * 
Ip  « 
Hr 
tr* 
k  it 


TestSACS.c 

Shuf flingInstructionSets 
continued 
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*  * 
*  * 

it  ir 


for  (i=l;  i<Iinax;  i++) 

Juinp=Yes; 

for  (j-i;  j>0  &&  Jun5)==Yes;  j — ) 


if  (BlockAddress (DataAddress [ j ] ) ==BlockAddress (DataAddress [ j-1 ] ) ) 
Juntp=No; 

if  ( (randO % (Associativity*NoLoadStoresInTestCases) )==0) 

Juinp=No;  /*  Gives  Uniform  distrabution.  */ 

if  (Jur[p==Yes) 

jump-CanBeSwitched (DataAddress,  j,  Imax) ; 

if  (Juinp==Yes) 

{ 

RequestTen53=*Request  [j-1] ; 

Request [j-1] “Request [ j]  ; 

Request  [  j  ]  =RequestTertp; 

AddressTemp“DataAddress [j-1] ; 

DataAddress [ j-1 ] “DataAddress [ j ] ; 

DataAddress [ j ] “AddressTemp; 

SizeTemp=Size [ j-1 ] ; 

Size[ j-l]*Size[ j] ; 

Size [ j ] “SizeTemp; 

TimeTemp=TimeUntilNextRequest [ j-lj ; 

TimeUntilNextRequest [ j-1 ] =TimeUntilNextRequest [ j ]  ; 
TimeUntilNextRequest  [  j  ]  “TimeTeitp; 

} 

} 

} 

} 


** 
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** 

CanBeSwitched 

** 

** 

** 

**  DESCRIPTION: 

1r* 

**  Can  InstructionAddress [i]  be  switched  with  Instruction [ i-1 ] .  ** 
**  If  so  return  Yes,  else  return  No.  ** 
*♦  ** 


YesNoType  CanBeSwitched(DataAddress,  lo, 
unsigned  long  int  *DataAddress; 
int  lo; 

int  Imax; 


Imax) 


{ 


int 

YesNoType 
YesNoType 
YesNoType 
unsigned  long 


j; 

Jun?)“Yes ; 

NoJuit^jed; 
JumpedBefore; 
int  Addressjumped[100] ; 


Junp-Yes; 


NoJun?)ed-l; 

AddressJumpedfOJ^BlockAddress (DataAddress Ilo] ) ; 
i-Io-2; 

while  (i>=0  &&  NoJun53ed<Associativity  && 

BlockAddress (DataAddress [i] ) !«BlockAddress (DataAddress  tIo-1] > ) 

{ 

JuitpedBe  f  o  r  e-No ; 

for  (j“0;  j<NoJuit53ed;  j++) 

if  (AddressJuirped[  j]  ==BlockAddress  (DataAddress  [i] ) )  JuxrpedBefore-Yes; 
if  (Juzi?>edBefore“»No  &&  NoJuinped<Associativity) 

AddressJunped [No Juiiped++]  “BlockAddress  (DataAddress  [i] ) ; 
i — ; 

if  (NoJ\ainped>“Associativity)  Jump“No; 


NoJuitped-1; 

Address Jumped [ 0 ] “BlockAddress (DataAddress [ lo-l ) ) ; 
i“Io+l; 

while  (.r<Imax  &&  NoJuiiped<Associativity  && 

BlockAddress  (DataAddress  [i] )  '.“BlockAddress  (DataAddress  [lo] ) ) 

{ 

JvmpedBe  f  or  e-No ; 

for  (j*0;  j<NoJumped;  j++) 

if  (AddressJuinped[  j] ““BlockAddress  (DataAddress  [i] ) )  J\impedBefore“Yes; 
if  ( JuinpedBefore*“No  &&  NoJuitped<Associativity) 

AddressJxnrped [No Junped++]  “BlockAddress  (DataAddress  [i] ) ; 
i++; 

} 

if  (NoJumped>“Associativity)  Jump-No; 


return  (Jiomp) ; 
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TestSACS . c 

** 

it* 

** 

** 

WritelnstructionSet 

** 

it  it 

it* 

it* 

Description: 

*  * 

it* 

** 

it  it 

Write  SACS.Dat 

one  line  at  a  time. 

** 

*♦  ** 


void  WritelnstructionSet (Request, 

DataAddress, 

Size, 

TimeUntilNextRequest, 

Imax) 

char  ‘Request; 

AddressType  ‘DataAddress; 

SizeType  ‘Size; 

TimeType  ‘TimeUntilNextRequest; 
int  Imax; 

int  i; 

for  (i-O;  i<Imax;  i++) 

fprintf  (DatciFile,  "%c  "  ,  Request  [i] ) ; 

fprintf  (DataiFile,  "%081X  ",  DataAddress  [i) )  ; 
fprintf (DataFile, "%2u  "  ,Size[i]); 
fprintf  (DatciFile,  "%lu"  ,  TimeUntilNextRequest  [i] ) ; 

fprintf (DataFile, "\n") ; 

} 

fprintf (DataFile, "End  Of  Trace\n\n") ; 
fprintf (DataFile, "If  any  instructions  follow\n"); 
fprintf (DataFile, "they  were  not  used  for  the\n"); 
fprintf (DataFile, "last  run.  \n"); 

fprintf  (DateiFile,  "\n") ; 


} 
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Part  Of  SACS  1.0 
(StillAnother  Cache  Simulator) 

Program  Modified:  3/17/94 
File  Modified:  3/17/94 

Author:  William  G.  Smith 

Address:  Electrical  Engineering  Department 
Naval  Postgraduate  School 
Monterey,  CA  93940 

Copyright  1994,  William  G.  Smith 

Permission  to  use,  copy,  modify,  and  distribute  this  software  and 
its  documentation  for  any  purpose  and  without  fee  is  hereby  granted 
provided  that  the  above  copyright  notice  appears  in  all  copies.  No 
modified  version  of  this  program  should  be  redistributed  without  the 
authors  consent.  William  G.  Smith  makes  no  warranty  or 
representation,  promise  of  guarantee,  either  expressed  or  inplied, 
with  respect  to  this  software' s  ability  to  produce  valid  results . 

This  program  is  provided  "as  is"  any  financial,  personal  or  property 
damage  caused  by  the  use  of  this  program  is  the  responsibility  of  the 
user. 


it* 

** 


Description: 


/****************♦*****************•********♦********★************************* 
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Checking. c  ** 

** 
*  * 
** 

Checking. c  contains  all  of  the  functions  that  relate  to  error  ** 

checking.  Note  that  an  error  could  be  raised  anywhere.  The  error  ** 

mesage  will  contain  the  procedure  name  in  square  brackets.  This  ** 

section  contains  the  functions  spicifically  designed  to  check  variable  ** 
to  see  if  they  are  consitant  with  each  other,  and  if  they  are  within  ** 
set  boundarys. 


*  * 

irit 

itit 

*  it 

*  it 
itit 
it* 
** 


Tcd)le  of  Contents 


*  * 
** 
** 
** 
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List  of  Cache. c  Function  Declarations  .. 
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** 

Checking  0  . 
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** 

*  * 

CheckingConstants ()  . 
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13-  4 

** 

*  * 

PrintConstError ()  . 

. .  Page 

13-11 

** 

** 

CheckingForValuesOutOfBounds ()  . 

. .  Page 

13-12 

*  * 

** 

PrintTimeBoundaryError ( ) ;  . 

. .  Page 

13-15 

** 

*  * 

PrintScoreBoundaryError () ;  . 

. .  Page 

13-16 

** 

*  * 

PrintSizeBoundaryError ( ) ;  . 

. .  Page 

13-17 

*  * 

** 

PrintEnumBoundaryError ( ) ;  . 

.  .  Page 

13-18 

*  * 

** 

CheckingForInconsistencies ()  . 

. .  Page 

13-19 

** 

** 

Print TotalTimeError ( )  . 

. .  Page 

13-21 

** 

*  * 

Print TotalScoreError 0  . 

. .  Page 

13-22 

** 

** 

CheckingPredictions ()  . 

. .  Page 

13-23 

** 

** 

PrintScorePredictionError 0  . 

. .  Page 

13-24 

** 

** 

** 

PrintTimePredictionError ()  . 

. .  Page 

13-25 

** 

** 

♦include  "Global. h" 
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Checking . c 


it* 
** 
** 
** 
** 
** 
*  * 


List  of  Checking. c  Function  Declarations 


Description: 


This  is  a  list  of  function  declarations  within  the  file  scope 
*  of  "Checking. c" . 


** 
** 
** 
** 
** 
** 
** 
*  * 


void  Checking  0; 

/* 

Page 

13-  3 

*/ 

void 

CheckingConstants () ; 

/* 

Page 

13-  4 

*/ 

void 

PrintConstError  0 ; 

f* 

Page 

13-11 

*/ 

void 

CheckingForValuesOutOfBounds ( ) ; 

/* 

Page 

13-12 

*/ 

void 

PrintTimeBoundaryError  0 ; 

/* 

Page 

13-15 

*/ 

void 

PrintScoreBoundaryError  0 ; 

/* 

Page 

13-16 

*/ 

void 

PrintSizeBoundaryError ( ) ; 

/* 

Page 

13-17 

*/ 

void 

PrintEnumBoundaryError ( ) ; 

/* 

Page 

13-18 

*/ 

void 

CheckingForInconsistencies () ; 

!* 

Page 

13-19 

*/ 

void 

PrintTotalTimeError ( ) ; 

/* 

Page 

13-21 

*/ 

void 

PrintTotalScoreError ( ) ; 

/* 

Page 

13-22 

*/ 

void  CheckingPredictions 0 ; 

/* 

Page 

13-23 

*/ 

void 

PrintScorePredictionError () ; 

/* 

Page 

13-24 

*/ 

void 

PrintTimePredictionError () ; 

/* 

Page 

13-25 

*/ 

/**«*******************************************'***'*********************#***•«* 
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**  Checking. c  ** 

♦  ★  ** 

**  Checking 

*# 

**  Description: 

irir 

**  Checking  checks  the  global  variables  to  insure  that  constants 

**  remain  constant,  and  Values  are  in  bounds,  als  that  there  are  no 
**  inconsistencies. 


ir* 
** 
irir 
it  * 
ir  ir 


*  * 


void  Checking () 

{ 

CheckingConstants (No) ; 
CheckingForValuesOutOf Bounds ( ) ; 
CheckingForInconsistencies  0 ; 

} 
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** 

Checking . c 

*  * 

** 

** 

** 

Che  ckingCons t ant  s 

** 

** 

** 

it  it 

Description: 

** 

it  it 

** 

it* 

Checking  global  constants  to  insure  that 

they  do  not  change,  ** 

it  -k 

unless  they  are  being  Reset. 

** 

it  it 

*  * 

•^★•******-*-*'V'*-**#^  v^e-#***-*  **  k  i  «  ******* 

****************************/ 

void  CheckingConstants (Reset) 
YesNoType  Reset; 

( 

static  CacheSizeType 
static  SizeType 
static  SizeType 
static  AssociativityType 
static  SizeType 

static  TimeType 
static  TimeType 
static  TimeType 
static  TimeType 
static  TimeType 
static  TimeType 

static  TimeType 
static  TimeType 
static  TimeType 

static  BufferSizeType 
static  BufferSizeType 

static  BlockReplacementPolicyType 

static  WritePolicyType 

static  WriteMissPolicyType 

static  YesNoType 

static  YesNoType 

static  YesNoType 

static  YesNoType 

static  YesNoType 

static  YesNoType 

static  PriorityType 
static  PriorityType 
static  PriorityType 
static  PriorityType 
static  PriorityType 

static  YesNoType 

static  YesNoType 
static  char 

static  HistograunIndexType 
static  HistogramIndexType 


CacheSizeCopy ; 

BlockSizeCopy; 

SubBlockSizeCopy; 

AssociativityCopy; 

WordSizeCopy; 

ReadCacheAcce  s  s  TimeCopy ; 
ReadCacheHitTimeCopy; 

ReadCacheMis  sTimeCopy ; 
WriteCacheAccessTimeCopy; 
WriteCacheHitTimeCopy; 
WriteCacheMissTimeCopy; 

MemoryAccessTimeCopy; 

MemoryTransferTimeCopy; 

BufferCacheAccessTimeCopy; 

ReadBufferSizeCopy; 

WriteBufferSizeCopy; 

BlockReplacementPolicyCopy; 
WritePolicyCopy; 
WriteMissPolicyCopy; 
ReadForwardCopy ; 
CPUWaitsForCacheWritesCopy; 

Sear chBlockBu f f erCopy ; 

Upda t  eReadBu  f  f er Copy ; 

Remo  veReadDup  1  i  cat  e  sCopy ; 
RemoveWriteDuplicatesCopy; 

ReadPriorityCopy; 

WritePriorityCopy; 

ReadForWriteAllocatePriorityCopy; 

WriteDirtyBlockPriorityCopy; 

NoPriorityCopy; 

CheckCopy; 

KeyBoardlOCopy ; 

♦DataFileNameCopy; 

ScreenHistogramMaxIndexCopy; 

FileHistogramMaxIndexCopy; 


** 
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** 

Checking. c 

*  * 

** 

** 

CheckingConstants 

** 

itir 

continued 

** 

static  SizeType 
stacu-C  SizeType 
static  SizeType 


NiomberOfBlocksCopy; 

NumberOfSubBlocksCopy; 

NumberOfSetsCopy; 


static  AddressType  *CacheBlockAddressCopy; 

static  TimeType  *LastCacheBlockAccessTimeCopy; 


static  SizeType 


*CacheNextBlockCopy; 


static  YesNoType  **CacheValidBitCopy; 

static  YesNoType  **CacheDirtyBitCopy; 


static  TimeType 
static  TimeType 

static  TimeType 
static  TimeType 


*  *RequestTimeHistogrcimCopy ; 
**StallTimeHistogramCopy; 

*TotalRequestTimeCopy; 

*TotalStallTimeCopy; 


static  ScoreType 
static  ScoreType 
static  ScoreType 
static  ScoreType 
static  ScoreType 


♦NumberOfAccessesCopy; 
♦NiimberOfCacheHitsCopy; 
•NiimberOfBufferHitsCopy; 
♦Predict edNumberOfAccessesCopy; 
♦PredictedNumberOfHitsCopy; 


static  FILE 


♦DataFileCopy; 
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it* 

Che eking. c 

** 

** 

** 

** 

CheckingConstants 

** 

** 

continued 

** 

** 

** 

f  (Reset) 

{ 

CacheSizeCopy 

BlockSlzeCopy 

SubBlockSizeCopy 

AssociativityCopy 

WordSizeCopy 

ReadCacheAccessTimeCopy 

ReadCacheHitTimeCopy 

ReadCacheMiasTimeCopy 

WriteCacheAccessTimeCopy 

WriteCacheHitTimeCopy 

WriteCacheMissTimeCopy 

MemoryAccessTimeCopy 

MemoryTransferTimeCopy 

BufferCacheAccessTimeCopy 

ReadBufferSizeCopy 

WriteBufferSizeCopy 

Bloc)tReplacementPolicyCopy 

WritePolicyCopy 

WriteMissPolicyCopy 

ReadForwardCopy 

CPUWaitsForCacheWritesCopy 

SearchBlockBufferCopy 

Updat  eReadBu  f  f  e  r Copy 

RemoveReadDuplicatesCopy 

RexnoveWriteDuplicatesCopy 

ReadPriorityCopy 

WritePriorityCopy 

ReadForWriteAllocatePriorityCopy 

WriteDirtyBlockPriorityCopy 

NoPriorityCopy 

CheckCopy 

KeyBoardlOCopy 

DataFileNameCopy 

ScreenHistogramMaxIndexCopy 
F i leHl s t ogramMax IndexCopy 


••  CacheSize; 

BlockSize; 

■  SubBlockSize; 

■  Associativity; 

••  WordSize; 

»  ReadCacheAccessTime; 

“  ReadCacheHitTime; 

=  ReadCacheMissTime; 

=  WriteCacheAccessTime; 

»  WriteCacheHitTime; 

-  WriteCacheMissTime; 

=  MemoryAccessTime; 

»  MemoryTransferTime; 

“  BufferCacheAccessTime; 

■  ReadBufferSize; 

■  WriteBufferSize; 

=  BlockReplacementPolicy; 

=  WritePolicy; 

»•  WriteMissPolicy; 

-  ReadForward; 

“  CPUWaitsForCacheWrites; 

=  SearchBlockBuffer; 

=  Updat eReadBu ffer; 

=  RemoveReadDupli cates; 

=  RemoveWriteDuplicates; 

=  ReadPriority; 

»  WritePriority; 

-  ReadForWriteAllocatePriority 

-  WriteDirtyBlockPriority; 

-  NoPriority; 

=  Check; 

-  KeyBoardIO; 

=  DataFileNaroe; 

-  ScreenHistogramMaxIndex; 

-  FileHistogramMaxIndex; 


Checking . c 


Page  13-7 


ir  It 


*♦ 
** 
** 


CheckingConstants 

continued 


♦  * 
*  * 


NumberOfBlocksCopy 

NumoerOt&uDiiiocKsCopy 

NiunberOfSetsCopy 

CacheBlockAddressCopy 

LastCacheBlockAccessTimeCopy 

CacheNextBlockCopy 

CacheValidBitCopy 

CacheDirtyBitCopy 

Reque s t TimeH i s t ogramCopy 
StallTimeHistogramCopy 

TotalRequestTimeCopy 

TotalStallTimeCopy 

NumberOfAcceseesCopy 
NumberOfCacheHitsCopy 
NumberOfBufferHitsCopy 
P  redict edNumberOf Accea  se  sCopy 
Predict  edNvunberOfflitsCopy 

DataFileCopy 

} 


“  NumberOfBlocks; 

-  NumberOtSubBlocks; 

=  NumberOfSets; 

=  CacheBlockAddress; 

=  LastCacheBlockAccessTime; 

=  CacheNextBlock; 

=  CacheValidBit; 

“  CacheDirtyBit; 

-  RequestTimeHistogram; 

=  StallTiroeHistogram; 

=  TotalRequestTime; 

-  TotalStallTime; 

=  NumberOfAccesses; 

=  NumberOfCacheHits; 

-  NiunberOfBufferHits; 

=  PredictedNumberOf Accesses; 
■  PredictedNumberOf Hits; 

••  DataFile; 
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**  ** 

**  CheckingConstants  ** 
**  continued  .  ** 
**  ** 


if  ( ! (Reset) ) 


if (  CacheSizeCopy 

PrintConstError ("CacheSize") ; 
if (  BlockSizeCopy 

PrintConstError ("BlockSize") ; 
if  (  SiibBlockSizeCopy 

PrintConstError ("SubBlockSize") ; 
if (  AssociativityCopy 

PrintConstError ("Associativity") ; 
if (  WordSizeCopy 

PrintConstError ("WordSize") ; 
if (  ReadCacheAccessTimeCopy 


CacheSize) 


BlockSize) 


SubBlockSize) 

Associativity) 

WordSize) 

ReadCacheAccessTime ) 


PrintConstError ("ReadCacheAccessTime") ; 
if(  ReadCacheHitTimeCopy  !-  ReadCacheHitTime) 

PrintConstError ("ReadCacheHitTime") ; 
if  (  ReadCacheMissTimeCopy  !=»  ReadCacheMissTime) 
PrintConstError ("ReadCacheMissTime") ; 
if(  WriteCacheAccessTimeCopy  WriteCacheAccessTime) 

PrintConstError ("WriteCacheAccessTime") ; 
if(  WriteCacheHitTimeCopy  1-  WriteCacheHitTime) 

PrintConstError ("WriteCacheHitTime") ; 
if(  WriteCacheMissTimeCopy  !■'  writeCacheMissTime) 

PrintConstError ("WriteCacheMissTime") ; 
if (  MemoryAccessTimeCopy  !=  MemoryAccessTime) 

PrintConstError ("MemoryAccessTime") ; 
if(  MemoryTransferTimeCopy  !*  MemoryTransferTime) 

PrintConstError ("MemoryTransferTime") ; 
if(  BufferCacheAccessTimeCopy  !-  BufferCacheAccessTime) 

PrintConstError ("Buff erCacheAccessTime") ; 
if(  ReadBufferSizeCopy  !»  ReadBufferSize) 

PrintConstError ("ReadBufferSize") ; 
if(  WriteBufferSizeCopy  !=  WriteBufferSize) 

PrintConstError ("WriteBufferSize") ; 
if(  BlockReplacementPolicyCopy  !-  BlockReplacementPolicy) 

PrintConstError ("BlockReplacementPolicy") ; 
if(  WritePolicyCopy  !»•  WritePolicy) 

PrintConstError ( "WritePolicy " ) ; 
if (  WriteMissPolicyCopy  I-  WriteMissPolicy) 

PrintConstError ("WriteMissPolicy") ; 
if(  ReadForwardCopy  !»  ReadForward) 

PrintConstError ("ReadForward") ; 

if(  CPUWaitsForCacheWritesCopy  !-  CPUWaitsForCacheWrites) 

PrintConstError ("CPUWaitsForCacheWrites") ; 
if(  SearchBlockBufferCopy  -  SearchBlockBuffer) 

PrintConstError ("SearchBlockBuffer") ; 
if(  UpdateReadBufferCopy  1-  UpdateReadBuffer) 

PrintConstError ("UpdateReadBuffer") ; 
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Checking. c  ** 

it* 


it  it 
it  it 
it  it 

*  * 


CheckingConstants 

continued 


** 
*  # 
*ir 


if(  RemoveReadDuplicatesCopy  !=  RemoveReadDuplicates) 

PrintConstError ("RemoveReadDuplicates") ; 
if (  RemoveWriteDuplicatesCopy  !=  RemoveWriteDuplicates) 

PrintConstError ("RemoveWriteDuplicates") ; 
if (  ReadPriorityCopy  !=  ReadPriority) 

PrintConstError ( "ReadPriority " ) ; 
if(  WritePriorityCopy  !»  WritePriority) 

PrintConstError ( "WritePriority " ) ; 

if(  ReadForWriteAllocatePriorityCopy  !=  ReadForWriteAllocatePriority) 
PrintConstError ( "ReadForWriteAllocatePriority" ) ; 
if (  WriteDirtyBlockPriorityCopy  !-  WriteDirtyBlockPriority) 

PrintConstError ( "WriteDirtyBlockPriority" ) ; 
if(  NoPriorityCopy  !=  NoPriority) 

PrintConstError ("NoPriority") ; 
if (  CheckCopy  !-  Check) 

PrintConstError ("Check") ; 

if(  KeyBoardlOCopy  !=  KeyBoardIO) 

PrintConstError ("KeyBoardIO") ; 
if(  DataFileNameCopy  !-  DataFileName) 

PrintConstError ("DataFileName") ; 
if(  ScreenHistogramMaxIndexCopy  !-  ScreenHistogramMaxIndex) 

PrintConstError  ("ScreenHistograinMaxindex”)  ; 
if(  FileHistogramMaxIndexCopy  !-  FileHistogramMaxlndex) 

PrintConstError ( "FileHistogramMaxlndex" ) ; 


if(  NiomberOfBloclcsCopy  !=•  NumberOfBlocks) 

PrintConstError ("NumberOfBlocks") ; 
if(  NiunberOfSubBlocksCopy  !*  NxunberOfSubBlocks) 

PrintConstError  ("NxomberOfSubBlocks") ; 
if(  NiomberOfSetsCopy  !=  NumberOfSets) 

PrintConstError ("NumberOf Sets") ; 
if(  cacheBlockAddressCopy  !-  CacheBlockAddress) 

PrintConstError ("CacheBlockAddress") ; 
if(  LastCacheBlockAccessTimeCopy  !=  LastCacheBlockAccessTime) 

PrintConstError ("LastCacheBlockAccessTime") ; 
if(  CacheNextBlockCopy  !-  CacheNextBlock) 

PrintConstError ("CacheNextBlock") ; 
if (  CacheValidBitCopy  !=  CacheValidBit) 

PrintConstError ("CacheValidBit") ; 
if(  CacheDirtyBitCopy  CacheDirtyBit) 

PrintConstError ("CacheDirtyBit") ; 
if(  RequestTimeHistogramCopy  !-  RequestTimeHistogram) 

PrintConstError ("RequestTimeHistogram")  ; 
if(  StallTimeHistogramCopy  !=•  StallTimeHistogram) 

PrintConstError ( " StallTimeHistogram" )  ; 
if<  TotalRequestTimeCopy  !=  TotalRequestTime) 

PrintConstError ("TotalRequestTime" ) ; 
if(  TotalStallTimeCopy  !-  TotalStallTime) 

PrintConstError ("TotalStallTime") ; 
if  (  NumberOfAccessesCopy  !-  NximberOfAccesses) 

PrintConstError ("NxunberOf Accesses") ; 
if(  NumberOf CacheHitsCopy  !=  NumberOf CacheHits) 

PrintConstError ("NumberOf CacheHits") ; 
if(  NumberOfBufferHitsCopy  !-  NumberOfBufferHits) 

PrintConstError ("NumberOfBufferHitsCopy") ; 
if (  PredictedNumberOfAccessesCopy  !»  PredictedNuinberOf Accesses) 
PrintConstError ( "PredictedNumberOf Accesses " ) ; 
if(  PredictedNumberOf  HitsCopy  PredictedNumberOf  Hits) 

PrintConstError ( "PredictedNumberOfHits" ) ; 
if (  DataFileCopy  !=  DataFile) 

PrintConstError ("Datafile") ; 

) 


} 


r  * 
r  * 
r* 
r  it 
r  * 
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it  it 
if  it 
Hit 
it  it 


roid  PrintConstError (VariableNarae) 
char  *VariableNaine; 

{ 

printf ("\n\nError  in  [CheckingConstants] ") ; 

printfj"  \n%s  did  not  remain  constant . \n",  VariableName) ; 

exit ( 0 ) ; 

} 
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★  ★  ★* 


CheckingForValuGSOutOfBounds 


**  Description: 


*  * 
** 


ir* 

Itir 

*ir 


CheckingForValuesOutOfBounds  checks  all  bounded  global  varicQjles  ** 
**  to  see  if  they  fall  within  their  prescribed  boundaries.  ** 
**  ** 


void  CheckingForValuesOutOfBounds () 


TimeType  MaxTime  “10000000001; 

ScoreType  MaxScore“10000000001; 

SizeType  Blockindex; 

SizeType  SubBlockIndex; 

SizeType  Setindex; 

RequestType  Request Index; 

CacheWaitingForType  Stallindex; 

if  (Time<0 

I  I  Tiitie>MaxTime) 

PrintTimeBoundaryError ("Time",  Time, 01,  MaxTime) ; 

if  (  CacheWaitingFor<Nothing 

I  1  CacheWaitingFor>NumberOfCacheWaitingForsAvailable) 
PrintEniunBoundaryError ("CacheWaitingFor", CaoheWaitingFor, 

Nothing,  NumberOfCacheWaitingForsAvailable) ; 

if  (  MemoryWaitingFor<NothingTwo 

I  I  MemoryWaitingFor>NuinberOfMemoryWaitingForsAvailable) 
PrintEnumBoundaryError  < "Memo ryWaitingFor ", Memo ryWaitingFor, 

NothingTwo,  NxanberOfMemoryWaitingForsAvailable) ; 

if  (  BlockWaitingFor<NothingThree 

I  I  BlockWaitingFor>NumberOfBlockWaitingForsAvailable) 
PrintEniunBoundaryError ("BlockWaitingFor",  BlockWaitingFor, 

NothingThree,  NumberOfBlockWaitingForsAvailable  ) ; 

if  (  CacheHit<No 

I  I  CacheHit>Unknown) 

PrintEnumBoundaryError ("CacheHit", CacheHit, No, Unknown) ; 

if  (  CacheBusy<No 
I  I  CacheBusy>Yes) 

PrintEnumBoundaryError ("CacheBusy", CacheBusy, No,  Yes) ; 
if  (  Request<None 

I  I  Reciuest>NumberOfRequestsAvailable) 

PrintEniunBoundaryError ( "Request " , Request , 

None,NumberOfRequestsAvailable) ; 

if  (  LastRequest<None 

I  I  LastRequest>Number0fRequest3Available) 

P  r intEnumBoundaryErr o  r ( ” La s t Reque st".  Request, 

None,NumberOfRequestsAvailable) ; 
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CheckingForValuesOutOfBounds  ** 

continued  ** 


if  (  RequestSize<0 

I  I  RequestSize>BlockSi2e) 

PrintSizeBoundaiyError ("RequestSize",  RequestSize,  0,  BlockSize); 

if  (  RequestBlockNumber<0 

I  I  RequestBlockN\jmber>-NuinberOf Blocks) 

{ 

Print SizeBoundaryError ( "RequestBlockNuntoer" , RequestBlockNumber, 

0,NuinberOf Blocks) ; 


if  (  TimeOfNextRequest<0 

I  I  TiineOfNextRequest>MaxTime) 

PrintT; meBoundaryError ("TimeOfNextRequest", TimeOfNextRequest, 

01,MaxTime) ; 

for  (SetIndex=0;  SetIndex<NuinberOfSets;  Setlndex++) 
if  (  CacheNextBlock [Set Index ] <0 

I  I  CacheNextBlock  [  Set  Index  ]  >*NuinberOfBlocks ) 

PrintSizeBoundaryError ("CacheNextBlock", CacheNextBlock [Setindex] , 

0,NuitiberOfBlocks) ; 

for  (BlockIndex“0;  BlockIndex<NuinberOfBlocks;  BlockIndex++) 

( 

for  (SubBlockIndex“0;  SubBlockIndex<NuinberOfSubBlocks?  SubBlockIndex++) 
{ 

if  (  CacheValidBit [Blockindex] [SubBlocklndex] <0 
I  I  CacheValidBit [Blockindex] [ SubBlocklndex ]> 1 ) 
PrintEnxunBoundaryError ( " CacheValidBit " , 

CacheValidBit [Blockindex] [SubBlocklndex] , 

0,1); 

if  (  CacheDirtyBit [Blockindex] [SubBlocklndex] <0 
I  I  CacheDirtyBit [Blockindex] [SubBlocklndex] >1) 

Pr  intEniimBoundaryError  ( "  CacheDirtyBit  ” , 

CacheDirtyBit (Blockindex] [SubBlocklndex] , 

0,1); 

} 


for  (Request lndex“0;  Request Index<NuinberOfRequestsAvailable;  Request Index++) 
if  (  TotalRequestTime [Request Index ] <0 
I  I  TotalRequestTime [RequestIndex]>Time) 

PrintTimeBoundaryError ("TotalRequestTime", 

TotalRequestTime  [Recjuest Index] , 

01, Time) ; 
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**  Checking. c  ** 
**  ** 


It* 

** 

** 


CheckingForValuesOutOfBounds 

continued 


for  (StallIndex-0; 

StallIndex<NiiinberOfCacheWaitingForsAvailable; 

Stalllndex++) 

if  (  TotalStallTime [Stallindex] <0 

I  I  TotalStallTime (Stallindex] >Time) 
PrintTimeBoundaryError ("TotalStallTime", 

TotalStallTime  [Stallindex] , 
01,  Time) ; 


if  (  TotalNumberOfAccesses<0 

I  I  TotalNumberOfAccessea>MaxScore) 

PrintScoreBoundaryError ( "TotalNvimberOf Accesses ", TotalNumberOf Accesses, 

01,  MaxScore) ; 

if  (  TOA<0 

I  I  TOA>MaxTime) 

PrintTimeBoundaryError ("TOA",  TOA,  01,  MaxTime); 

if  (  TOD<0 

I  I  TOD>MaxTime) 

PrintTimeBoundaryError ("TOD",  TOD,  01,  MaxTime); 

) 
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**  Checking. c  ** 
**  ★★ 

**  PrintTimeBoundaryError  ** 
*★  *★ 


void  PrintTimeBoundaryError (VariableName,  Value,  LowLimit,  HighLimit) 

char  * VariableName; 

TimeType  Value; 

TimeType  LowLimit; 

TimeType  HighLimit; 

printf ("\n\nError  found  in  [ CheckingForValuestOutOf Bounds] ") ; 
printf("  \n%s  is  out  of  prescribed  bounds. ", VariableName) ; 

printf  ("\n\n  The  value  was  .  "); 

Print Time (Value) ; 

printf  ("  \n  The  low  limit  was  .  "); 

PrintTime (LowLimit) ; 

printf  ("  \n  The  high  limit  was  .  "); 

PrintTime (HighLimit) ; 

printf ("\n\n") ; 

DiscrepancyFound=Yes ; 


} 
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**  Checking. c  ** 

*★  ★★ 

♦*  Print ScoreBoundaryError  ** 

**  .  ** 


void  PrintScoreBoundaryError  (VarietbleName,  Value,  LowLimit,  HighLimit) 

char  ‘VariableName; 

ScoreType  Value; 

ScoreType  LowLimit; 

ScoreType  HighLimit; 

{ 

printf ("\n\nError  found  in  [ CheckingForValuestOutOf Bounds] ") ; 
printf{"  \n%s  is  out  of  prescribed  bounds. ",VariableName) ; 

printf  ("\n\n  The  value  was  .  "); 

PrintScoreCentered (Value) ; 

printf  ("  \n  The  low  limit  was  .  "); 

PrintScoreCentered (LowLimit) ; 

printf  ("  \n  The  higu  limit  was  .  "); 

PrintScoreCentered (HighLimit) ; 

printf ("\n\n") ; 

DiscrepancyFound*»Yes ; 
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**  Checking. c  ** 

**  ** 

**  PrintSizeBoundaryError  ** 

**  ** 


void  PrintSizeBoundaryError (VariableName,  Value,  LowLimit,  HighLimit) 

char  * VariableName; 

SizeType  Value; 

SizeType  LowLimit; 

SizeType  HighLimit; 

i 

printf ("\n\nError  found  in  [CheckingForValuestOutOfBounds] ") ; 
printf("  \n%s  is  out  of  prescribed  bounds Varied^leName ) ; 

printf  ("\n\n  The  value  was  .  "); 

PrintSize (Value) ; 

printf  ("  \n  The  low  limit  was  .  ”); 

PrintSize (LowLimit) ; 

printf  ("  \n  The  high  limit  was  .  "); 

PrintSize (HighLimit) ; 

printf ("\n\n") ; 

DiscrepancyFound-Yes ; 

} 


/***************************************************************************** 
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**  Checking. c  ** 

**  ** 

**  PrintEniiinBoundaryError  ** 

void  PrintEnxunBoundaryError (VariableName,  Value,  LowLimit,  HighLimit) 

char  *VariableName; 
int  Value ; 
int  LowLimit ; 
int  HighLimit ; 


printf ("\n\nError  found  in  [CheckingForValuestOutOfBounds] ") ; 
printf("  \n%s  is  out  of  prescribed  bounds. ",VariableName) ; 

printf  ("\n\n  The  value  was  .  ">; 

printf ("%d", Value) ; 

printf {"  \n  The  low  limit  was  .  "); 

printf ("%d",  LowLimit) ; 

printf  ("  \n  The  high  limit  was  .  "); 

printf ("%d", HighLimit) ; 

printf ("\n\n") ; 


DiscrepancyFound-Yes ; 
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**  Checking. c  ** 

**  ** 

**  CheckingForInconsistencies {)  ** 

**  • 


void  CheckingForInconsistencies  0 

CacheWaitingForType  CacheWaitingFor Index; 

RequestType  Requestindex; 

TijneType  TotalTime; 

ScoreType  SiunOfAccesses; 

HistogramIndexType  Histogramlndex; 

ScoreType  PredictedNumberOfWordsReadFromMemory; 

TotalTime-O; 

for  (CacheWaitingForIndex-Nothing; 

CacheWaitingForlndex<NuinberO£CacheWaitingForsAvailable; 

CacheWaitingForIndex++) 

TotalTime+^TotalStallTime [CacheWaitingFor Index] ; 
if  (TotalTime! -Time) 

PrintTotalTimeError (Time, TotalTime,  "Stalls") ; 
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CheckingFor Inconsistencies () 


TotalTime-0; 

for  (RequestIndex“Nothing; 

Request  Inciex<N\niiberOfRequestsAvailable; 
Request Index++ ) 

TotalTijne+“TotalRequestTime [Requestindex] ; 


if  (TotalTime'.-Time) 

PrintTotalTimeError (Time,  TotalTime, "Requests") ; 

for  (Request Index-Read; 

Requestlndex<NufflberOfRequestsAvailable; 

Request Index++) 

{ 

SumOf Accesses  -  0; 

for  (HistogramIndex-0; 

HistogramIndex<FileHistogramMaxIndex; 

HistogramIndex++) 

SumOfAccesses+-RequestTimeHistogram {Request Index) [Histogramindex) 

if  (SumOfAccesses l-NumberOfAccesses [Requestindex] ) 

PrintTotalScoreError (NumberOf Accesses (Requestindex] , 

SumOfAccesses, 

Requeststring (Requestindex] ) ; 


} 

if  (CacheWaitingFor— Nothing  &&  ReadBuffer .Empty—Yes  && 

UpdateReadBuffer— No  &&  SearchBlockBuffer— No  && 

RemoveReadDuplicates=*Yes  &&  WriteMis3Policy==WriteAround  ) 

{ 

PredictedNumberOfWordsReadFromMemory- 
(NumberOfAccesses [Read] 

-NumberOf CacheHits [Read] 

-NumberOfBuf ferHits [Read] ) *BlockSize/WordSize; 
if  (PredictedNumberOfWordsReadFromMemory ! - 
TotalNumberOfWordsReadFromMemory) 

PrintTotalScoreError (PredictedNumberOfWordsReadFromMemory, 

TotalNumberOfWordsReadFromMemory, 
"Read  Misses"); 

) 
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**  Checking,  c  ** 
**  ** 


PrintTotalTimeError 


_  ** 

**  ** 


void  PrintTotalTimeError (TimeValue,  TotalTimeValue,  VariableName) 

TimeType  TimeValue; 

TimeType  TotalTimeValue; 
char  *VarieQ3leName; 

i 

printf ("\n\nError  found  in  [CheckingFor Inconsistencies]  the  total  sum"); 
printf("  \nof  %s  times  does  not  equal  the  actual  time.",  VariableName); 

printf ("\n\n  Total  time  was  equal  to  ...  "); 

Print Time (TimeValue) ; 

printf ("  \n  The  sxunation  of  %s",  VariableName); 

printf  ("  \n  times  was  .  "); 

PrintTime (TotalTimeValue) ; 

printf ("\n\n") ; 

DiscrepancyFound-Yes ; 

] 


*  ★ 
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Checking. c 

** 

irir 

** 

PrintTotalScoreError 

** 

** 

void  PrintTotalScoreError (TotalScoreValue,  SvunScoreValue,  VariableName) 

ScoreType  TotalScoreValue; 

ScoreType  SumScoreValue; 
char  * VariableName; 

{ 

printf ("\n\nError  found  in  [CheckingFor Inconsistencies]  the  total  for"); 
printf("  \n%s  does  not  equal  the  summation.",  VariableName); 

printf ("\n\n  Total  number  of  %s  accesses",  VaricdsleName) ; 

printf  ("  \n  was  equal  to  .  "); 

PrintScoreCentered (TotalScoreValue) ; 

printf ("  \n  The  sumation  of  %s  request  histogreun",  VariableName); 

printf  ("  \n  was  equal  to  .  "); 

PrintScoreCentered  ( SiimScoreValue ) ; 

printf ("\n\n") ; 

DiscrepancyFcnnd-Yes; 

) 
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** 

**  CheckingP redictions  ** 

**  ** 


void  CheckingPredictions 0 
{ 


if  (PredictedNiamberOf  Accesses  [Read]  !=NuinberOfAccesses  [Read] ) 

PrintScorePredictionError (PredictedNumberOfAccesses [Read] , 

NiunberOfAccesses  [Read] , 

"Read  Accesses"); 

if  (PredictedNiunberOf Accesses [Write] I -NumberOf Accesses [Write] ) 

PrintScorePredictionError (PredictedNiimberOfAccesses [Write] , 

NiunberOf Accesses  [Write] , 

"Write  Accesses"); 

if  (DiscrepancyFound“No) 

if  (PredictedNumberOfHits [Read]  !-  NumberOfCacheHits [Read] 

+  NuinberOfBufferHits  [Read]  £& 
BlockReplacementPolicy— LRU  && 

SearchBlockBuffer—Yes  &&  RemoveRead0uplicates-*>Yes) 

PrintScorePredictionError (PredictedNumberOfHits [Read] , 

NumberOfCacheHits [Read] 

+NumberOfBuf ferHits [Read] , 

"Read  Hits"); 

if  (PredictedNumberOfHits [Write]  !-  NumberOfCacheHits [Write] 

+  NumberOfBufferHits [Write]  && 

BlockReplacementPolicy“LRU  &&  WriteMissPolicy—WriteAllocate  && 
WritePolicy— WriteThrough) 

PrintScorePredictionError (PredictedNviroberOfHits [Write] , 

NumberOfCacheHits [Write] 

+NumberOfBuf ferHits [Write] , 

"Write  Hits"); 


} 


} 


*  * 

** 

It* 

** 
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void  PrintScorePredictionError (PredictedValue,  ActualValue,  VariableName ) 

ScoreType  PredictedValue; 

ScoreType  ActualValue; 
char  *VariableNeutie; 

{ 

printf  ("\n\nEr.vor  found  in  [CheckingPredictions]  when  trying  to  predict 
VariableName) ; 

printf("\n\n  The  predicted  value  was  ...  "); 

PrintScoreCentered (PredictedValue) ; 

printf{"  \n  The  actual  value  was  .  "); 

PrintScoreCentered (ActualValue) ; 

printf ("\n\n") ; 


DiscrepancyFound»Yes; 
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**  Checking,  c  ** 

** 


**  PrintTimePredictionError 

**  ** 
****************************************  ^r********************* *************** y 


void  PrintTimePredictionError (PredictedValue, 

ActualValue, 
RequestName, 
ProcedureName ) 


TimeType  PredictedValue; 

TimeType  ActualValue; 
char  *RequestName; 

char  *ProcedureName; 

{ 

printf ("\n\nError  found  in  (%s]  when  trying  to  predict  time  to  conplete  %s", 
ProcedureNaune,  RequestName )  ; 

printf ("\n\n  The  predicted  value  was  ...  "); 

PrintScoreCentered (PredictedValue) ; 

printf  ("  \n  The  actual  value  was  .  "); 

PrintScoreCentered (ActualValue) ; 

printf ("\n\n") ; 

DiscrepancyFound-Yes; 

} 


f 
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